logo
theme
COVID-19
FREE
By api-sports
Updated 2 months ago
COVID-19 Overview

Get statistics for all countries about COVID-19 [FREE TO USE]. Updated every 15 minutes. Documentation : https://api-sports.io/documentation/covid-19

provider
rating
add first rating
Followers on API
Follow this API
resourcesProvider WebsiteTerms of Service
More Details

COVID-19

Introduction

COVID-19 is a completely FREE API that allows you to follow the progress of the coronavirus around the world. We will try to work continuously on the API in order to make it progress and add constructive data. We are open to any suggestion to improve this API, do not hesitate to send us your ideas or the same bugs encountered to our support email address.

Version: 1.0.2

/countries

This endpoint refers to the list of countries affected by the Coronavirus.
A search function is available to quickly search for countries.
> Each country can be used as a filter in the other API endpoints.

Parameters
Name Located in Description Required Schema
x-rapidapi-host header covid-193.p.rapidapi.com No string
x-rapidapi-key header Your RapidAPI Key Yes string
search query Name of a country No string
// Get all countries available
get("https://covid-193.p.rapidapi.com/countries");
// Search a country
get("https://covid-193.p.rapidapi.com/countries?search=china");
Responses
{
   "get": "countries",
   "parameters": [],
   "errors": [],
   "results": 193,
   "response": [
       "Afghanistan",
       "Albania",
       "Algeria",
       "Andorra",
       "Angola",
       "Antigua-and-Barbuda",
       "Argentina",
       "Armenia",
       "Aruba",
       "Australia",
       "Austria",
       "Azerbaijan",
       "Bahamas",
       "Bahrain",
       "Bangladesh"
   ]
}

/statistics

This endpoint reflects the current status of the spread of the coronavirus in all countries.
It is possible to filter per country to retrieve its current status.
For the current situation in the world use All
> We update the data every 15 minutes.

Parameters
Name Located in Description Required Schema
x-rapidapi-host header covid-193.p.rapidapi.com No string
x-rapidapi-key header Your RapidAPI Key Yes string
country query Name of a country No string
// Get the current status of all countries
get("https://covid-193.p.rapidapi.com/statistics");
// Get the current status for a specific country
get("https://covid-193.p.rapidapi.com/statistics?country=china");
// Get the current status in the world
get("https://covid-193.p.rapidapi.com/statistics?country=all");
Responses
{
   "get": "statistics",
   "parameters": [],
   "errors": [],
   "results": 194,
   "response": [
       {
           "country": "China",
           "cases": {
               "new": "+46",
               "active": 5353,
               "critical": 1845,
               "recovered": 72440,
               "total": 81054
           },
           "deaths": {
               "new": "+6",
               "total": 3261
           },
           "tests": {
               "total": 256
           },
           "day": "2020-03-22",
           "time": "2020-03-22T22:45:05+00:00"
       },
       {
           "country": "Italy",
           "cases": {
               "new": "+5560",
               "active": 46638,
               "critical": 3000,
               "recovered": 7024,
               "total": 59138
           },
           "deaths": {
               "new": "+651",
               "total": 5476
           },
            "tests": {
               "total": 256
           },
           "day": "2020-03-22",
           "time": "2020-03-22T22:45:05+00:00"
       },
       {
           "country": "Spain",
           "cases": {
               "new": "+3107",
               "active": 24722,
               "critical": 1785,
               "recovered": 2125,
               "total": 28603
           },
           "deaths": {
               "new": "+375",
               "total": 1756
           },
            "tests": {
               "total": 256
           },
           "day": "2020-03-22",
           "time": "2020-03-22T22:45:05+00:00"
       }
   ]
}

/history

This endpoint refers to the entire history of statistics for a country.
A new entry is generated each time one of the data has evolved or regressed.
For global results, replace country with All.
> We update the data every 15 minutes.

Parameters
Name Located in Description Required Schema
x-rapidapi-host header covid-193.p.rapidapi.com No string
x-rapidapi-key header Your RapidAPI Key Yes string
country query Name of a country Yes string
day query Date [YYYY-MM-DD] No string
// Get the complete historical data of a country
get("https://covid-193.p.rapidapi.com/history?country=china");
// Get the complete historical data of a country and filter by day
get("https://covid-193.p.rapidapi.com/history?country=china&day=2020-03-21");
// Get the complete historical data around the world
get("https://covid-193.p.rapidapi.com/history?country=all");
// Get the complete historical data around the world and filter by day
get("https://covid-193.p.rapidapi.com/history?country=all&day=2020-03-21");
Responses
{
   "get": "history",
   "parameters": {
       "country": "china"
   },
   "errors": [],
   "results": 2,
   "response": [
       {
           "country": "China",
           "cases": {
               "new": "+46",
               "active": 5353,
               "critical": 1845,
               "recovered": 72440,
               "total": 81054
           },
           "deaths": {
               "new": "+6",
               "total": 3261
           },
            "tests": {
               "total": 256
           },
           "day": "2020-03-22",
           "time": "2020-03-22T22:45:05+00:00"
       },
       {
           "country": "China",
           "cases": {
               "new": null,
               "active": 6013,
               "critical": 1927,
               "recovered": 71740,
               "total": 81008
           },
           "deaths": {
               "new": null,
               "total": 3255
           },
            "tests": {
               "total": 256
           },
           "day": "2020-03-22",
           "time": "2020-03-22T01:00:05+00:00"
       }
   ]
}
Have a question about this API?Ask the API Provider.
More by api-sports
Developers who viewed COVID-19 also viewed

Install SDK for (Node.js)Unirest

OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication