{"id":13553434,"url":"https://github.com/disease-sh/API","last_synced_at":"2025-04-03T05:30:51.869Z","repository":{"id":40244710,"uuid":"245077032","full_name":"disease-sh/API","owner":"disease-sh","description":"API for Current cases and more stuff about COVID-19 and Influenza","archived":false,"fork":false,"pushed_at":"2024-08-01T16:01:58.000Z","size":4527,"stargazers_count":2469,"open_issues_count":8,"forks_count":631,"subscribers_count":74,"default_branch":"master","last_synced_at":"2025-03-27T13:07:42.277Z","etag":null,"topics":["api","cdc","corona","coronavirus","coronavirus-tracking","covid","covid-19","covid19","discord","discord-server","disease","postman","redis"],"latest_commit_sha":null,"homepage":"https://disease.sh","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/disease-sh.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-05T05:28:12.000Z","updated_at":"2025-03-21T20:13:26.000Z","dependencies_parsed_at":"2023-02-13T10:15:27.665Z","dependency_job_id":"cedbc4f5-2d87-4119-9c4a-be5a9cda846b","html_url":"https://github.com/disease-sh/API","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disease-sh%2FAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disease-sh%2FAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disease-sh%2FAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/disease-sh%2FAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/disease-sh","download_url":"https://codeload.github.com/disease-sh/API/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246944377,"owners_count":20858773,"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","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":["api","cdc","corona","coronavirus","coronavirus-tracking","covid","covid-19","covid19","discord","discord-server","disease","postman","redis"],"created_at":"2024-08-01T12:02:24.602Z","updated_at":"2025-04-03T05:30:51.428Z","avatar_url":"https://github.com/disease-sh.png","language":"JavaScript","funding_links":[],"categories":["Get to Know","JavaScript"],"sub_categories":[],"readme":"![Logo](./public/assets/img/icon-long.png)\n\u003cbr\u003e\u003cbr\u003e\n\n![DockerHub Downloads](https://img.shields.io/docker/pulls/novelcovid/novelcovid-api?style=for-the-badge)\n![GitHub contributors](https://img.shields.io/github/contributors-anon/disease-sh/api?style=for-the-badge)\n![ESLint](https://img.shields.io/github/workflow/status/disease-sh/API/Eslint?label=ESLint\u0026style=for-the-badge)\n![Tests](https://img.shields.io/github/workflow/status/disease-sh/API/Unittest?label=Tests\u0026style=for-the-badge)\n![GitHub top language](https://img.shields.io/github/languages/top/disease-sh/api?style=for-the-badge)\n![GitHub issues](https://img.shields.io/github/issues/disease-sh/api?style=for-the-badge)\n![GitHub closed issues](https://img.shields.io/github/issues-closed/disease-sh/api?style=for-the-badge)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/disease-sh/api?style=for-the-badge)\n![GitHub closed pull requests](https://img.shields.io/github/issues-pr-closed/disease-sh/api?style=for-the-badge)\n![Visits](https://badges.pufler.dev/visits/disease-sh/api?style=for-the-badge)\n\n# Welcome to disease.sh - An open API for disease-related statistics\n\n| Information | Discord |\n|:------------|:---------:|\n| This API provides a big range of detailed information about multiple viruses. From COVID19 global data overviews to city/region specific mobility data, and data on the current outbreak of Influenza. We also provide official government data for some countries, more to be added soon.\u003cbr\u003e\u003cbr\u003eThe core-team currently consists of 4 people from 4 different countries working hard to keep this up and running, but it's an open-source project, so if you want, come help us!| [![Discord server](https://external-content.duckduckgo.com/iu/?u=https%3A%2F%2Fimg.icons8.com%2Fcolor%2F2x%2Fdiscord-logo.png\u0026f=1\u0026nofb=1)](https://discord.gg/cEDxzfW) |\n\n**Check out** our homepage and **sign up** for our newsletter [here](https://disease.sh/)\n\n## Recommended by Postman\nDisease.sh is recommended by Postman [here](https://covid-19-apis.postman.com/)\n\n[![Run in Postman](https://run-beta.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/11144369-e27366d6-7699-46f4-b58e-2b2b2e637be5-Szf6Z9B3)\n\n## Run through [databar.ai](https://databar.ai)\nIf you don't know how to use APIs, you can use disease.sh without code through the [databar.ai](https://databar.ai) platform.\n\n[![Run without code](https://databar.ai/external/ref_button.svg)](https://databar.ai/explore/open-disease-data-api?utm_source=diseasesh\u0026utm_campaign=apiref)\n\n## Documentation\nDisease.sh Documentation can be found [here](https://disease.sh/docs/)\n\n# Installation\n\n## Without Docker\n\n### Redis\n1. Download redis from https://redis.io/topics/quickstart\n2. Start redis server using `redis-server`\n\n### Project\n1. Fork and clone the git repository\n2. In the new folder you will find a `example.env` file, duplicate it and rename it to `.env` only.\n3. in the new `.env` file, change `REDIS_HOST` to localhost\n4. Change the env variables to fit your environment (leave them blank for default values)\n6. In one window run `redis-server`\n7. Run `npm ci` to install the packages\n8. In another window run `npm run start:dev`\n9. Open your browser and navigate to `localhost:{PORT}` (PORT being the port specified in your `.env` file)\n10. You should now see the APIs landing page\n\n## With docker-compose\n1. Fork and clone the git repository\n2. In the new folder you will find a `example.env` file, duplicate it and rename it to `.env` only.\n3. Change the env variables to fit your environment (leave them blank for default values)\n4. Run `npm run docker-start-dev` to run the local version of the API with Docker\n5. Run `npm run docker-start` to run the published version of the API with Docker\n\n# Recommended Javascript Wrapper\n\u003cdir align =\"center\"\u003e\n\u003ca href=\"https://www.npmjs.com/package/novelcovid\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/v/novelcovid?logo=npm\u0026style=for-the-badge\" alt=\"Version\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/novelcovid\"\u003e\n\t\u003cimg src=\"https://img.shields.io/bundlephobia/min/novelcovid?color=red\u0026label=SIZE\u0026logo=npm\u0026style=for-the-badge\", alt=\"Size\"\u003e\n\u003c/a\u003e\n\u003ca href=\"https://www.npmjs.com/package/novelcovid\"\u003e\n\u003cimg src=\"https://img.shields.io/npm/dw/novelcovid?logo=npm\u0026style=for-the-badge\", alt=\"Downloads\"\u003e\n\u003c/a\u003e\n\u003c/dir\u003e\n\n- [Github](https://github.com/disease-sh/node-api)\n- [NPM](https://npmjs.com/novelcovid)\n\n\u003e For further support, you can join our discord server! More Tutorials can be found there too!\n\u003e https://discord.gg/cEDxzfW\n\n# Showcases (Awesome-NovelCOVID)\n\nDid you build a project with our API? We now offer an \"awesome-list\" for you to add your projects into so people can find out about them!\n\n#### You can find it \u003ca href=\"https://github.com/disease-sh/awesome-novelcovid\"\u003ehere\u003c/a\u003e.\n\n# Sources:\n\u003e https://www.worldometers.info/coronavirus/\n\n\u003e https://github.com/CSSEGISandData/COVID-19/tree/master/csse_covid_19_data/csse_covid_19_time_series\n\n\u003e https://github.com/nytimes/covid-19-data\n\n\u003e https://github.com/ActiveConclusion/COVID19_mobility\n\n\u003e https://www.canada.ca/en/public-health/services/diseases/2019-novel-coronavirus-infection.html\n\n\u003e https://github.com/pcm-dpc/COVID-19\n\n\u003e https://www.rki.de/DE/Content/InfAZ/N/Neuartiges_Coronavirus/Situationsberichte/Gesamt.html\n\n\u003e https://info.gesundheitsministerium.at/\n\n\u003e https://www.mohfw.gov.in/\n\n\u003e https://covid19.ncdc.gov.ng/\n\n\u003e https://github.com/openZH/covid_19/\n\n\u003e https://coronavirus.data.gov.uk\n\n\u003e https://covid19.go.id\n\n\u003e https://datadashboard.health.gov.il/COVID-19/general\n\n# Contributing\n- [How to Contribute](./CONTRIBUTING.md)\n\n# Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/ebwinters\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/4297028?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eEthan Winters\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3Aebwinters\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n\t  \u003ctd align=\"center\"\u003e\u003ca href=\"https://pufler.dev\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/17516174?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJulian Pufler\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=puf17640\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/himanshu2406\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/37951606?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eHimanshu Rathore\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=himanshu2406\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://404discord.xyz/\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/41652412?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eapollyon600\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=apollyon600\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://jshelley.uk\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/22616014?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJames Shelley\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/pulls?q=is%3Apr+reviewed-by%3AJamesShelley\" title=\"Reviewed Pull Requests\"\u003e👀\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"http://RyanHarlow.com\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/42226213?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eRyan Harlow\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3ARyanHarlow\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/alitas\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/1144691?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAli Tas\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3Aalitas\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/buster95\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/15637669?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eWalter Corrales\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=buster95\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://AhmadAwais.com\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/960133?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAhmad Awais ⚡️\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=ahmadawais\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://discord.gg/rk7cVyk\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/39545629?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMrAugu\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3AMrAugu\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"http://chroventer.github.io\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/34645569?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAyyan Lewis\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3Achroventer\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"http://bensommer.co.uk\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/39101651?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eBen Sommer\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3Abenjamin-sommer\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"https://github.com/disease-sh/API/commits?author=benjamin-sommer\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/nibble-4bits\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/38052706?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eLuis De Anda\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=nibble-4bits\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n\t  \u003ctd align=\"center\"\u003e\u003ca href=\"http://olukadeno@gmail.com\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/37341054?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eOluka Denis\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/issues?q=author%3AOlukaDenis\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://lioncoding.com\"\u003e\u003cimg src=\"https://avatars0.githubusercontent.com/u/26142591?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eKodjo Laurent Egbakou\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=egbakou\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://github.com/jsebastianms1\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/22509688?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJuan Sebastián Marulanda Sánchez\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=jsebastianms1\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.linkedin.com/in/collin-street/\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/30121540?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eCollin-St\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=Collin-St\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"http://marveldc.me\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/24299563?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eMarvelDC\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=MarvelDC\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://zentreax.dev/\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/36458019?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eZentreaxᴰᵉᵛ\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=Zentreax\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003ca href=\"https://www.jeffpelton.com/\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/36627?v=4\" width=\"100px;\" alt=\"\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ecomster\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/disease-sh/API/commits?author=comster\" title=\"Code\"\u003e💻\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-enable --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\n# License\n[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2FNovelCOVID%2FAPI.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2FNovelCOVID%2FAPI?ref=badge_large)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdisease-sh%2FAPI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdisease-sh%2FAPI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdisease-sh%2FAPI/lists"}