Awesome
Covid-19-API
This API deprecated on the 31st of October, 2022.
This is the code running in AWS Lambda powering covid-api.mmediagroup.fr/v1
<!-- wp:paragraph --> <p>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.</p> <!-- /wp:paragraph --> <!-- wp:paragraph --> <p><a href="https://blog.mmediagroup.fr/post/m-media-coronavirus-api-passes-1-million-requests/">This API has now been called over <a href="https://blog.mmediagroup.fr/post/m-media-covid-api-passes-30-million-requests/">30 million times now!</a></p> <!-- /wp:paragraph --> <!-- wp:paragraph --> <p>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.</p> <!-- /wp:paragraph --> <!-- wp:paragraph --> <p>You can see a human-friendly webpage that uses the API here <a href="https://mmediagroup.fr/covid-19">https://mmediagroup.fr/covid-19</a>.</p> <!-- /wp:paragraph --> <!-- wp:heading --> <h2>What the API is for</h2> <!-- /wp:heading --> <!-- wp:paragraph --> <p>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.</p> <!-- /wp:paragraph --> <!-- wp:paragraph --> <p>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.</p> <!-- /wp:paragraph --> <!-- wp:heading --> <h2>Using the API</h2> <!-- /wp:heading --> <!-- wp:paragraph --> <p>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 :)!</p> <!-- /wp:paragraph --> <!-- wp:paragraph --> <p>API base:<br><a rel="noreferrer noopener" href="https://covid-api.mmediagroup.fr/v1/cases" target="_blank">https://covid-api.mmediagroup.fr/v1</a></p> <!-- /wp:paragraph --> <!-- wp:heading {"level":3} --> <h3>Live cases data</h3> <!-- /wp:heading --> <!-- wp:paragraph --> <p>Request:<br>GET <a rel="noreferrer noopener" href="https://covid-api.mmediagroup.fr/v1/cases" target="_blank">/cases</a></p> <!-- /wp:paragraph --> <!-- wp:paragraph --> <p>Optional query parameters</p> <!-- /wp:paragraph --> <!-- wp:list --> <ul> <li>country<ul><li>Any country name (case sensitive)</li></ul></li> <li>ab<ul><li>Any country ISO abbreviation (example: FR) (takes precedence over "country" parameter)</li></ul></li> <li>continent<ul><li>Any world continent (example: Europe) (takes precedence over "country" parameter)</li></ul></li> </ul> <!-- /wp:list --> <!-- wp:paragraph -->Example request:
<pre><code class="lang-http"><span class="hljs-attr">GET /cases?country</span>=<span class="hljs-string">France</span> </code></pre>Example response:
{
"All": {
"confirmed": 2604595,
"recovered": 195365,
"deaths": 62548,
"country": "France",
"population": 64979548,
"sq_km_area": 551500,
"life_expectancy": "78.8",
"elevation_in_meters": 375,
"continent": "Europe",
"abbreviation": "FR",
"location": "Western Europe",
"iso": 250,
"capital_city": "Paris",
"lat": "46.2276",
"long": "2.2137",
"updated": "2020/12/26 12:21:56+00"
},
"French Guiana": {
"lat": "4",
"long": "-53",
"confirmed": 12685,
"recovered": 9995,
"deaths": 71,
"updated": "2020/12/26 12:21:56+00"
}
}
Example request:
<pre><code class="lang-http">GET /<span class="hljs-built_in">history</span>?country=Germany&status=deaths </code></pre>Example response:
{
"All": {
"country": "Germany",
"population": 82114224,
"sq_km_area": 357022,
"life_expectancy": "77.4",
"elevation_in_meters": 263,
"continent": "Europe",
"abbreviation": "DE",
"location": "Western Europe",
"iso": 276,
"capital_city": "Berlin",
"dates": {
"2020-12-25": 29580,
"2020-12-24": 29330,
"2020-12-23": 28909,
"2020-12-22": 28096,
"2020-12-21": 27110
}
}
}
Example request:
<pre><code class="lang-http"><span class="hljs-attr">GET /vaccines?country</span>=<span class="hljs-string">France</span> </code></pre>Example response:
{
"All": {
"administered": 7927771,
"people_vaccinated": 2297100,
"people_partially_vaccinated": 5630671,
"country": "France",
"population": 64979548,
"sq_km_area": 551500,
"life_expectancy": "78.8",
"elevation_in_meters": 375,
"continent": "Europe",
"abbreviation": "FR",
"location": "Western Europe",
"iso": 250,
"capital_city": "Paris",
"lat": "46.2276",
"long": "2.2137",
"updated": "2020/12/26 12:21:56+00"
}
}