{"id":36495161,"url":"https://github.com/alaeddinemessadi/covid-19-report-api","last_synced_at":"2026-01-12T02:01:04.489Z","repository":{"id":40775507,"uuid":"248759463","full_name":"AlaeddineMessadi/COVID-19-REPORT-API","owner":"AlaeddineMessadi","description":"⚕️🚑    COVID-19 API Service to keep tracking cases worldwide 🌍","archived":false,"fork":false,"pushed_at":"2023-12-20T14:16:26.000Z","size":5548,"stargazers_count":17,"open_issues_count":28,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-23T11:30:18.403Z","etag":null,"topics":["api","api-rest","api-server","corona","corona-server","coronavirus-analysis","coronavirus-info","coronavirus-real-time","coronavirus-tracking","covid","covid-19","covid-api","covid-data","express","expressjs","javascript","node","nodejs"],"latest_commit_sha":null,"homepage":"https://alaeddinemessadi.github.io/COVID-19-REPORT-API","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/AlaeddineMessadi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-03-20T13:15:48.000Z","updated_at":"2023-03-20T14:39:43.000Z","dependencies_parsed_at":"2023-12-06T15:47:58.060Z","dependency_job_id":null,"html_url":"https://github.com/AlaeddineMessadi/COVID-19-REPORT-API","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/AlaeddineMessadi/COVID-19-REPORT-API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlaeddineMessadi%2FCOVID-19-REPORT-API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlaeddineMessadi%2FCOVID-19-REPORT-API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlaeddineMessadi%2FCOVID-19-REPORT-API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlaeddineMessadi%2FCOVID-19-REPORT-API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AlaeddineMessadi","download_url":"https://codeload.github.com/AlaeddineMessadi/COVID-19-REPORT-API/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AlaeddineMessadi%2FCOVID-19-REPORT-API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28331509,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T00:36:25.062Z","status":"online","status_checked_at":"2026-01-12T02:00:08.677Z","response_time":98,"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":["api","api-rest","api-server","corona","corona-server","coronavirus-analysis","coronavirus-info","coronavirus-real-time","coronavirus-tracking","covid","covid-19","covid-api","covid-data","express","expressjs","javascript","node","nodejs"],"created_at":"2026-01-12T02:00:21.282Z","updated_at":"2026-01-12T02:01:04.481Z","avatar_url":"https://github.com/AlaeddineMessadi.png","language":"JavaScript","funding_links":["https://www.patreon.com/AlaeddineMessadi"],"categories":[],"sub_categories":[],"readme":"# COVID-19-REPORT-API\n\nCOVID-19-REPORT-API is an API Service to keep tracking  COVID-19 cases worldwide\n\n[Preview](https://covid-19-report-api.now.sh)\n\n\u003cdiv align=\"center\"\u003e\n\t\u003cbr\u003e \u003cimg src=\"/static/corona-mask.png\" width=\"80px\"\u003e \u003cbr\u003e \u003chr\u003e\n\u003c/div\u003e\n\n\n## Get Started\n\n### Prerequisites\n [npm](https://www.npmjs.com/get-npm) or [yarn](https://yarnpkg.com/en/docs/install) installed\n\n```shell\n# clone the repo\n$ git clone https://github.com/AlaeddineMessadi/COVID-19-REPORT-API.git\n\n# install dependencies\n$ yarn    ## or npm install\n\n# run in development mode\n$ yarn dev   ## npm run dev\n\n# run tests\n$ yarn test  ## npm run test\n```\n\n\n\n## Run the service\n#### Run in *development* mode:\nRuns the application is development mode. Should not be used in production\n\n```shell\n$ yarn dev\n## or with debug\n$ yarn dev:debug\n```\n\n#### Run in *production* mode:\n\nCompiles the application and starts it in production production mode.\n\n```shell\n$yarn compile\n$ yarn start\n```\n\n## Documentation\n\n\n```markdown\n# Get me a brief report\n[GET]   /api/v1/cases/brief\n\n# Get me a brief timeseries \n[GET]   /api/v1/cases/brief/timeseries\n\n# Get me all latest cases in the world or in specific region or country\n[GET]   /api/v1/cases/latest   # parameters {iso: String, province: String, onlyCountries: Boolean}\n\n#! iso parameter can be iso2 or iso3 for example: US or USA , CN or CHN\n\nexamples:\n[GET]   /api/v1/cases/latest\n[GET]   /api/v1/cases/latest?onlyCounties=true\n[GET]   /api/v1/cases/latest?iso=US\n[GET]   /api/v1/cases/latest?iso=US\u0026onlyCounties=true\n[GET]   /api/v1/cases/latest?onlyCounties=true\n[GET]   /api/v1/cases/latest?iso=AU\u0026province=New+South+Wales\n[GET]   /api/v1/cases/latest?province=New+South+Wales\n\n# Get me all timeseries in the world or in specific region or country\n[GET]   /api/v1/cases/timeseries   # parameters {iso: String, province: String, onlyCountries: Boolean}\n\nexamples:\n[GET]   /api/v1/cases/timeseries\n[GET]   /api/v1/cases/timeseries?onlyCounties=false\n[GET]   /api/v1/cases/timeseries?iso=DE\n[GET]   /api/v1/cases/timeseries?iso=AU\u0026province=New+South+Wales\n[GET]   /api/v1/cases/timeseries?province=New+South+Wales\n[GET]   /api/v1/cases/timeseries?iso=CH\u0026onlyCounties=true\n\n# Secret me list of contries/regions with iso2 and iso3\n[GET]   /api/v1/cases/countries\n\n# Secret endpoint to update Database\n[GET]   /api/v1/cases/udpate?secret=secret\n\n#! change your secret in the .env file\n\n\n# Get ALL \n[GET]   /api/v1/cases\n\n#! response will be huge!! \n```\n\n## Test It\n\nRun the Mocha unit tests  **TO DO: ** more tests to implement\n\n```shell\n$ yarn test\n## or\n$ yarn test:debug\n```\n\n## Try It\n* Open you're browser to [http://localhost:3000](http://localhost:3000)\n* Invoke the `/cases` endpoint \n  ```shell\n  curl http://localhost:3000/api/v1/cases/brief\n  ```\n\n## Lint It\n\nFix all prettier linter errors\n\n```shell\n$ yarn lint\n```\n\n[![Total alerts](https://img.shields.io/lgtm/alerts/g/AlaeddineMessadi/COVID-19-REPORT-API.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/AlaeddineMessadi/COVID-19-REPORT-API/alerts/)\n\n## Deployment\n\n```shell\n$ now\n```\n[![Deploy with ZEIT Now](https://zeit.co/button)](https://deploy.now.sh/?repo=https://github.com/AlaeddineMessadi/COVID-19-REPORT-API)\n\n### Data Source\n\ndata repository for the 2019 Novel Coronavirus Visual Dashboard operated by the Johns Hopkins University Center for Systems Science and Engineering ([JHU CSSE](https://github.com/CSSEGISandData/COVID-19))\n\n### MIT License\n\n[![MIT license](https://img.shields.io/badge/License-MIT-blue.svg)](https://lbesson.mit-license.org/) \n[![forthebadge](https://forthebadge.com/images/badges/built-with-love.svg)](https://github.com/AlaeddineMessadi)\n\n\n\n## Support:\n\u003ca href=\"https://www.patreon.com/AlaeddineMessadi\"\u003e\n\t\u003cimg src=\"https://c5.patreon.com/external/logo/become_a_patron_button@2x.png\" width=\"160\"\u003e\n\u003c/a\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falaeddinemessadi%2Fcovid-19-report-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falaeddinemessadi%2Fcovid-19-report-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falaeddinemessadi%2Fcovid-19-report-api/lists"}