In our bid to do our part, we’ve created a free public API for others to build apps upon. The API returns live cases and historical data. To date, our API has served over 2 million requests.
The API has endpoints to handle historical as well as near realtime data (updated once every hour). The average API response time is between 70 and 250 ms but may take up to 3 seconds, depending if the request is in the cache or not.
We’ve also made a simple webpage that uses the API, available here: https://mmediagroup.fr/covid-19.
What the API is for
The API is intended for developers, machines, programs, and other websites to be able to quickly fetch up to date information on the COVID-19 epidemic.
It can be used to build tools and systems that are used for data analysis all the way to websites that act as public dashboards and charts.
Using the API
For up to date information on endpoints and API usage, check our GitHub: github.com/M-Media-Group/Covid-19-API
M Media
If you’re a developer, you can use the API right now. Please be nice to us and cache the data locally so we don’t pay too much :)!
API base:https://covid-api.mmediagroup.fr/v1
Live cases data
Request: GET /cases
Optional query parameters
- country
- Any country name (case sensitive)
Example request:GET /cases?country=France
Historical cases data
Request:GET /history
Required query parameters
- status
- Confirmed
- Deaths
- Recovered (Depreciated on 25/03/2020)
Optional query parameters
- country
- Any country name (case sensitive)
Example request:GET /history?country=France&status=Confirmed
Authorization
No authorisation is required to fetch data from the API.
Data sources
Historical data: https://github.com/CSSEGISandData/COVID-19
Realtime data: https://opendata.arcgis.com/datasets/bbb2e4f589ba40d692fab712ae37b9ac_1.csv
Population data:
https://github.com/M-Media-Group/country-json/blob/master/src/countries-master.json
Contributing to the API
If you’re a developer and would like to contribute to the development of this API, you can check out the Github repo here: https://github.com/M-Media-Group/Covid-19-API
Donate to the API
This API has now been used over 2 million times, and that racks up in server costs. If you’d like to help out, please consider donating/sponsoring us!
