leiurus17 / coronavirus-ph-api

🦠A simple and fast (< 200ms) api for tracking the coronavirus (COVID-19, SARS-CoV-2) outbreak in the Philippines.

coronavirus-ph (API)

🦠A simple and fast (< 200ms) api for tracking the coronavirus (COVID-19, SARS-CoV-2) outbreak in the Philippines.

Endpoints

All requests must be made to the base url: https://coronavirus-ph-api.herokuapp.com (e.g: https://coronavirus-ph-api.herokuapp.com/cases). You can try them out in your browser to further inspect responses.

Getting summary of COVID-19 cases in the Philippines:

GET /cases

[
  {
    "case_no": 1,
    "date": "2020-01-30",
    "age": 38,
    "gender": "F",
    "nationality": "Chinese",
    "hospital_admitted_to": "San Lazaro Hospital",
    "had_recent_travel_history_abroad": "Yes",
    "status": "Recovered",
    "other_information": "First case of COVID-19 in PH",
  },
  {...}
]

Getting confirmed cases of Filipino nationals outside the Philippines:

GET /cases-outside-ph

[
  {
    "country_territory_place": "Diamond Princess",
    "confirmed": 80,
    "recovered": 70,
    "died": 0
  },
  {...}
]

Getting Laboratory Status of Patients in the Philippines

GET /test-results

{
  "confirmed_cases": 636,
  "cases_tested_negative": 728,
  "cases_pending_test_results": 595
}

Getting Metro Manila Community Quarantine Checkpoints:

GET /mm-checkpoints

[
  {
    "id": 13,
    "district": "NORTHERN POLICE DISTRICT",
    "city": "VALENZUELA CITY",
    "location": "NLEX (ENTRANCE)",
    "type": "EntryExit",
    "lat": 14.768614,
    "lng": 120.967557,
    "description": "Not verified"
  },
  {...}
]

Getting a single Metro Manila Community Quarantine Checkpoint:

GET /mm-checkpoints/:id

{
  "id": 13,
  "district": "NORTHERN POLICE DISTRICT",
  "city": "VALENZUELA CITY",
  "location": "NLEX (ENTRANCE)",
  "type": "EntryExit",
  "lat": 14.768614,
  "lng": 120.967557,
  "description": "Not verified"
}

Getting Local government units under partial lockdown:

GET /lockdowns

[
  {
    "lgu": "Ilocos Norte",
    "region": "I",
    "start_date": "2020-03-14",
    "estimated_population": 593081,
    "cases": 0,
    "deaths": 0,
    "recovered": 0
  },
  {...}
]

Data

All data are programmatically retrieved, re-formatted and stored in the cache for one hour.

• Cases from r/Coronavirus_PH spreadsheet
• Wikipedia
• Metro Manila community quarantine checkpoints

Installation

• git clone https://github.com/sorxrob/coronavirus-ph-api.git
• cd coronavirus-ph-api
• cp .env.example .env
• npm install
• npm start

Running / Development

• npm run dev
• Visit your app at http://localhost:3030.

Testing

• npm test

In the Wild

A list of public websites that are using this API

• https://zntp.github.io/covidcase
• https://covid19ph-update.netlify.com
• https://covid19.nextvation.com
• https://www.facebook.com/dubrechi/posts/3417813594901888
• https://techron.info
• https://alexisrequerman.github.io/covid19ph
• http://www.armilwebdev.com/coronavirus
• https://ncov.gundamserver.com

Other apps

I also launched a coronavirus tracking website and open-sourced it!

Donate

License & copyright

© Robert C Soriano

Licensed under the MIT License.