{"id":28444292,"url":"https://github.com/bence-toth/covid-data","last_synced_at":"2025-09-13T14:35:22.819Z","repository":{"id":36967119,"uuid":"312569406","full_name":"bence-toth/covid-data","owner":"bence-toth","description":"COVID-19 data in JSON format, updated daily","archived":false,"fork":false,"pushed_at":"2023-03-28T19:58:24.000Z","size":227200,"stargazers_count":7,"open_issues_count":4,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-29T17:47:45.213Z","etag":null,"topics":["covid-19","covid-api","covid-data","covid19-data"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bence-toth.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-11-13T12:27:22.000Z","updated_at":"2022-11-03T07:11:35.000Z","dependencies_parsed_at":"2023-01-17T09:30:24.355Z","dependency_job_id":null,"html_url":"https://github.com/bence-toth/covid-data","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bence-toth/covid-data","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bence-toth%2Fcovid-data","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bence-toth%2Fcovid-data/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bence-toth%2Fcovid-data/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bence-toth%2Fcovid-data/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bence-toth","download_url":"https://codeload.github.com/bence-toth/covid-data/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bence-toth%2Fcovid-data/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274976892,"owners_count":25384285,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["covid-19","covid-api","covid-data","covid19-data"],"created_at":"2025-06-06T09:08:25.251Z","updated_at":"2025-09-13T14:35:22.812Z","avatar_url":"https://github.com/bence-toth.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# COVID-19 API\n\nThis repository contains COVID-19 data in JSON format.\n\n## ⚠️ This dataset is no longer updated\n\nOn 10 March 2023 the Johns Hopkins Coronavirus Resource Center ceased its collecting and reporting of global COVID-19 data, and therefore this dataset is no longer updated.\n\nFor updated cases, deaths, and vaccine data please visit the following sources:\n\n- Global: [World Health Organization (WHO)](https://www.who.int/)\n- U.S.: [U.S. Centers for Disease Control and Prevention (CDC)](https://www.cdc.gov/coronavirus/2019-ncov/index.html)\n\nFor more information, visit the [Johns Hopkins Coronavirus Resource Center](https://coronavirus.jhu.edu/).\n\n## API\n\nThe dataset contains the number of confirmed cases, the number of recoveries, and the number of deaths, both daily and cumulative values, and both exact values and values for one million inhabitants.\n\nThe first day of the dataset is 22 January 2020.\n\nYou can fetch the data using HTTP.\n\n### Counties and provinces\n\nThe countries and provinces the data is available for are listed in `data/countries.json`.\n\nThis file contains a JSON object with only one key `countriesAndProvinces` which is an array of objects which describe a country or province, including its slug, which is used in the file names that contain data for that specific country or province.\n\nA province’s slug is always prefixed with its country’s slug, and `--` is used as a delimiter.\n\nAn object which describes a country looks like:\n\n```json\n{\n  \"slug\": \"canada\",\n  \"name\": \"Canada\",\n  \"population\": 37742154,\n  \"latitude\": 56.1304,\n  \"longitude\": 106.3468\n}\n```\n\nAn object which describes a province looks like:\n\n```json\n{\n  \"slug\": \"canada--ontario\",\n  \"name\": \"Canada\",\n  \"province\": \"Ontario\",\n  \"latitude\": 51.2538,\n  \"longitude\": -85.3232,\n  \"population\": 14446515\n}\n```\n\nYou can fetch the data contained in this file by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/countries.json\n```\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/countries.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.countriesAndProvinces);\n  });\n```\n\n### Confirmed cases, daily\n\nThe daily confirmed cases for countries and provinces are available in the JSON files in the `data/confirmed/daily/exact/` folder.\n\nThese files contain a JSON object with only one key `dailyConfirmedCases` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/daily/exact/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/daily/exact/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.dailyConfirmedCases);\n  });\n```\n\n### Confirmed cases per one million inhabitants, daily\n\nThe daily confirmed cases per one million inhabitants for countries and provinces are available in the JSON files in the `data/confirmed/daily/per-million/` folder.\n\nThese files contain a JSON object with only one key `dailyConfirmedCasesPerMillion` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/daily/per-million/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/daily/per-million/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.dailyConfirmedCasesPerMillion);\n  });\n```\n\n### Confirmed cases, cumulative\n\nThe cumulative confirmed cases for countries and provinces are available in the JSON files in the `data/confirmed/cumulative/exact/` folder.\n\nThese files contain a JSON object with only one key `cumulativeConfirmedCases` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/cumulative/exact/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/cumulative/exact/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeConfirmedCases);\n  });\n```\n\n### Confirmed cases per one million inhabitants, cumulative\n\nThe cumulative confirmed cases per one million inhabitants for countries and provinces are available in the JSON files in the `data/confirmed/cumulative/per-million/` folder.\n\nThese files contain a JSON object with only one key `cumulativeConfirmedCasesPerMillion` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/cumulative/per-million/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/confirmed/cumulative/per-million/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeConfirmedCasesPerMillion);\n  });\n```\n\n### Deaths, daily\n\nThe daily deaths for countries and provinces are available in the JSON files in the `data/died/daily/exact/` folder.\n\nThese files contain a JSON object with only one key `dailyDeaths` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/daily/exact/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/daily/exact/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.dailyDeaths);\n  });\n```\n\n### Deaths per one million inhabitants, daily\n\nThe daily deaths per one million inhabitants for countries and provinces are available in the JSON files in the `data/died/daily/per-million/` folder.\n\nThese files contain a JSON object with only one key `dailyDeathsPerMillion` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/daily/per-million/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/daily/per-million/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.dailyDeathsPerMillion);\n  });\n```\n\n### Deaths, cumulative\n\nThe cumulative deaths for countries and provinces are available in the JSON files in the `data/died/cumulative/exact/` folder.\n\nThese files contain a JSON object with only one key `cumulativeDeaths` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/cumulative/exact/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/cumulative/exact/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeDeaths);\n  });\n```\n\n### Deaths per one million inhabitants, cumulative\n\nThe cumulative deaths per one million inhabitants for countries and provinces are available in the JSON files in the `data/died/cumulative/per-million/` folder.\n\nThese files contain a JSON object with only one key `cumulativeDeathsPerMillion` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/cumulative/per-million/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/died/cumulative/per-million/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeDeathsPerMillion);\n  });\n```\n\n### Recoveries, daily\n\nThe daily recoveries for countries and provinces are available in the JSON files in the `data/recovered/daily/exact/` folder.\n\nThese files contain a JSON object with only one key `dailyRecoveredCases` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/daily/exact/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/daily/exact/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.dailyRecoveredCases);\n  });\n```\n\n### Recoveries per one million inhabitants, daily\n\nThe daily recoveries per one million inhabitants for countries and provinces are available in the JSON files in the `data/recovered/daily/per-million/` folder.\n\nThese files contain a JSON object with only one key `dailyRecoveredCasesPerMillion` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/daily/per-million/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/daily/per-million/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.dailyRecoveredCasesPerMillion);\n  });\n```\n\n### Recoveries, cumulative\n\nThe cumulative recoveries for countries and provinces are available in the JSON files in the `data/recovered/cumulative/exact/` folder.\n\nThese files contain a JSON object with only one key `cumulativeRecoveredCases` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/cumulative/exact/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/cumulative/exact/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeRecoveredCases);\n  });\n```\n\n### Recoveries per one million inhabitants, cumulative\n\nThe cumulative recoveries per one million inhabitants for countries and provinces are available in the JSON files in the `data/recovered/cumulative/per-million/` folder.\n\nThese files contain a JSON object with only one key `cumulativeRecoveredCasesPerMillion` which is an array of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/cumulative/per-million/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/recovered/cumulative/per-million/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeRecoveredCasesPerMillion);\n  });\n```\n\n### Full datasets\n\nThe full datasets for countries and provinces are available in the JSON files in the `data/entire-dataset/` folder.\n\nThese files contain a JSON object with the following keys:\n\n- `cumulativeConfirmedCases`\n- `cumulativeConfirmedCasesPerMillion`\n- `dailyConfirmedCases`\n- `dailyConfirmedCasesPerMillion`\n- `cumulativeDeaths`\n- `cumulativeDeathsPerMillion`\n- `dailyDeaths`\n- `dailyDeathsPerMillion`\n- `cumulativeRecoveredCases`\n- `cumulativeRecoveredCasesPerMillion`\n- `dailyRecoveredCases`\n- `dailyRecoveredCasesPerMillion`\n\nThe values are arrays of numbers.\n\nYou can fetch the data contained in one of these files by sending a `GET` request to:\n\n```\nhttps://raw.githubusercontent.com/bence-toth/covid-data/main/data/entire-dataset/SLUG.json\n```\n\nWhere `SLUG` is to be replaced with the slug of the country or province.\n\nFor example:\n\n```js\nfetch(\n  \"https://raw.githubusercontent.com/bence-toth/covid-data/main/data/entire-dataset/canada.json\"\n)\n  .then((response) =\u003e response.json())\n  .then((result) =\u003e {\n    console.log(result.cumulativeConfirmedCases);\n    console.log(result.cumulativeConfirmedCasesPerMillion);\n    console.log(result.dailyConfirmedCases);\n    console.log(result.dailyConfirmedCasesPerMillion);\n    console.log(result.cumulativeDeaths);\n    console.log(result.cumulativeDeathsPerMillion);\n    console.log(result.dailyDeaths);\n    console.log(result.dailyDeathsPerMillion);\n    console.log(result.cumulativeRecoveredCases);\n    console.log(result.cumulativeRecoveredCasesPerMillion);\n    console.log(result.dailyRecoveredCases);\n    console.log(result.dailyRecoveredCasesPerMillion);\n  });\n```\n\n## Acknowledgements\n\nThe COVID data is fetched from [the GitHub repository](https://github.com/CSSEGISandData/COVID-19) of the 2019 Novel Coronavirus Visual Dashboard, which is operated by the [Johns Hopkins University Center for Systems Science and Engineering](https://systems.jhu.edu/), and it is updated daily.\n\nPopulation data and latitude/longitude of countries and provinces were collected from various sources, including [Word Population Review](https://worldpopulationreview.com) and [Wikipedia](https://en.wikipedia.org/wiki/Main_Page).\n\n## License\n\nLicensed under [MIT](./LICENSE). Do what you will.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbence-toth%2Fcovid-data","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbence-toth%2Fcovid-data","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbence-toth%2Fcovid-data/lists"}