{"id":15645979,"url":"https://github.com/k1m0ch1/covid-19-api","last_synced_at":"2025-07-26T09:34:50.296Z","repository":{"id":52151256,"uuid":"246889873","full_name":"k1m0ch1/covid-19-api","owner":"k1m0ch1","description":"🍰 Simple and 🦅 fast covid-19 api global data parser using Flask, data gathered from Novel Coronavirus (COVID-19) Cases, provided by JHU CSSE","archived":false,"fork":false,"pushed_at":"2022-12-08T03:49:47.000Z","size":209,"stargazers_count":49,"open_issues_count":4,"forks_count":16,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-04-30T11:17:29.040Z","etag":null,"topics":["api","bot","bot-whatsapp","corona","coronavirus","coronavirus-tracker","covid-19","covid19","docker","flask","golang","hacktoberfest","python","python3","robot","virus","webapp","whatsapp"],"latest_commit_sha":null,"homepage":"","language":"Python","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/k1m0ch1.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-03-12T17:10:31.000Z","updated_at":"2024-08-30T05:19:20.000Z","dependencies_parsed_at":"2023-01-24T10:00:46.552Z","dependency_job_id":null,"html_url":"https://github.com/k1m0ch1/covid-19-api","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/k1m0ch1/covid-19-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1m0ch1%2Fcovid-19-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1m0ch1%2Fcovid-19-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1m0ch1%2Fcovid-19-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1m0ch1%2Fcovid-19-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/k1m0ch1","download_url":"https://codeload.github.com/k1m0ch1/covid-19-api/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k1m0ch1%2Fcovid-19-api/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267145727,"owners_count":24042651,"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-07-26T02:00:08.937Z","response_time":62,"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","bot","bot-whatsapp","corona","coronavirus","coronavirus-tracker","covid-19","covid19","docker","flask","golang","hacktoberfest","python","python3","robot","virus","webapp","whatsapp"],"created_at":"2024-10-03T12:10:49.356Z","updated_at":"2025-07-26T09:34:50.271Z","avatar_url":"https://github.com/k1m0ch1.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Coronavirus Disease 19 API Tracker\n\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/k1m0ch1/covid-19-api)\n![GitHub repo size](https://img.shields.io/github/repo-size/k1m0ch1/covid-19-api)\n![GitHub last commit](https://img.shields.io/github/last-commit/k1m0ch1/covid-19-api)\n![GitHub stars](https://img.shields.io/github/stars/k1m0ch1/covid-19-api)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/k1m0ch1/covid-19-api)\n![GitHub forks](https://img.shields.io/github/forks/k1m0ch1/covid-19-api)\n![GitHub issues](https://img.shields.io/github/issues/k1m0ch1/covid-19-api)\n![GitHub watchers](https://img.shields.io/github/watchers/k1m0ch1/covid-19-api)\n![Twitter](https://img.shields.io/twitter/follow/bukanyahya?style=social)\n\nThis is just a simple API tracker for covid-19 latest information for recovered, confirmed and deaths cases. The main purpose of this repo is for bot announcement to whatsapp, telegram and discord about latest cases of covid-19.\n\nyou can try the api here [https://covid19-api.yggdrasil.id/](https://covid19-api.yggdrasil.id/) ![Website](https://img.shields.io/website?down_message=offline\u0026up_message=online\u0026url=https://covid19-api.yggdrasil.id/) thanks for @habibiefaried for helping the server\nor [![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)\n\n# Bot Whatsapp\n(WARNING: This is only available with Bahasa Language, need some help for translation)\nThis bot is for covid-19 information purpose by automatically answer for available data, by using `!covid \u003ccommand\u003e`, here is the available command :\n1. status\nThis will return information about current global case, example output\n```\nConfirmed: xx\nDeaths: xx\nRecovered: xx\n```\n2. id\nThis will return information about current indonesia corona case, example output\n```\nTerkonfirmasi: xx\nMeninggal: xx\nSembuh: xx\nDalam Perawatan: xx\n\nUpdate Terakhir:\n2020-03-17T07:01:01+00:00\n```\n3. id info\nThis will return basic information about corona in indonesia\n4. ping\nThe bot will response \"pong\"\n5. halo, hello, help\nThe introduction and list of available command\n## Requirement\nDocker\n## Installation\nrun this command\n```\ndocker run --restart on-failure --name gobot-covid k1m0ch1/gobot-covid\n```\nThe QR Code will be available in terminal for more less than 10 second, if timeout you need to run the first command again\nafter the QR Code is succesfully scanned I prefer to run the container in the background by stop the container first with `Ctrl+C` and then run the container again with command `docker start gobot-covid`\n\n### For advance usage\n- Session store\nThis feature will enable to store the session for the later use, by adding the argument as the file name for sesion for example\n```\ndocker run --restart on-failure --name gobot-covid k1m0ch1/gobot-covid MyPhoneNumber\n```\nthe file `MyPhoneNumber.go` will be stored at `./session` folder\n\nthe folder `session` in the container at path `/go/src/github.com/k1m0ch1/covid-19-api/session` so you can use `-v` parameter to put the session file in the localhost\n\nhere is the complete parameter\n```\ndocker run -v ~/session:/go/src/github.com/k1m0ch1/covid-19-api/session x--restart on-failure --name gobot-covid k1m0ch1/gobot-covid MyPhoneNumber\n```\n\n# Endpoint\n\n## Get latest information about confirmed, deaths and recovered\n```\nGET /\n```\n\n```\n{\"Confirmed\":167447,\"Deaths\":6440,\"Recovered\":76034}\n```\n## Get each countries confirmed, deaths, and recovered cases\n```\nGET /confirmed\n```\n\n```\n[\n    ...,\n    {\n        \"confirmed\": 14991,\n        \"countryRegion\": \"Iran\",\n        \"lastUpdate\": \"2020-03-16T14:38:45\",\n        \"latitude\": \"32.4279\",\n        \"longitude\": \"53.6880\",\n        \"provinceState\": null\n    }\n    ...,\n]\n```\nsame as result with endpoint `GET /deaths` and `GET /recovered`\n## Get latest information about all country cases status\n```\nGET /all\n```\n```\n[\n    ...,\n    {\n        \"Confirmed\": xx,\n        \"CountryRegion\": \"CountryName\",\n        \"Deaths\": xx,\n        \"LastUpdate\": \u003ctimestamp iso 8601 format\u003e,\n        \"Latitude\": \"xx.x\",\n        \"Longitude\": \"-xx.x\",\n        \"ProvinceState\": \"State\" or null,\n        \"Recovered\": xx\n    },\n    ...\n]\n```\n## List of available countries\n```\nGET /countries\n```\n## List of available countries detail cases\n```\nGET /countries/\u003calpha2-country-code\u003e\n```\n```\nGET /countries/us\n```\n```\n[\n    ...,\n    {\n        \"confirmed\": 557,\n        \"countryRegion\": \"US\",\n        \"deaths\": 7,\n        \"lastUpdate\": \"2020-03-16T23:53:03\",\n        \"latitude\": \"36.1162\",\n        \"longitude\": \"-119.6816\",\n        \"provinceState\": \"California\",\n        \"recovered\": 6\n    },\n    ...,\n    {\n        \"summary\": {\n            \"confirmed\": 4632,\n            \"deaths\": 85,\n            \"recovered\": 17\n        }\n    }\n    ...,\n]\n```\nif the country only have a single data, the summary data will not exist\n\n## List of available news\n```\nGET /news\n```\nget the latest top headlines about corona virus,\nthe news is get from `NewsAPI.org` see there for available news\n\n## List of available news in specific countries\n```\nGET /news/\u003calpha2-country-code\u003e\n```\nget the latest top headlines about corona virus in specific countries,\nthe news is get from `NewsAPI.org` see there for available news\n\n# Docker\nYou can use docker by pull\n```\ndocker run --name covid-19-api -p 5001:5001 -d docker.pkg.github.com/k1m0ch1/covid-19-api/covid-19-api:latest run\n```\nor\n```\ndocker run --name covid-19-api -p 5000:5000 -d docker.pkg.github.com/k1m0ch1/covid-19-api/covid-19-api:latest run_web_prod\n```\n\n# Development\nThis repo is still on development and feel free to contribute.\n## Requirement\n1. Python 3.7\n2. pipenv/ pip\n3. venv/ virtualenv\n\n## Running on development\n```\npipenv run python manage.py run\n```\n\n## Running on production\n```\npipenv run python manage.py run_web_prod\nor\ngunicorn --config python:src.gunicorn_cfg src.wsgi:app\n```\n\n## Next to do :\n- ~~deploy to server for public use~~ deployed to [https://covid19-api.yggdrasil.id/](https://covid19-api.yggdrasil.id/) Thanks @habibiefaried\n- ~~add new endpoint for each countries~~ referrence from @mathdroid\n- ~~add new endoint `/confirmed` `/deaths` and `/recovered`~~\n- bot discord\n- ~~bot whatsapp~~\n- bot telegram\n- news crawler from reliable resource\n\n## Bot Whatsapp to do :\n- ~~session is stored into specific volume, so can be used later~~\n- ~~prevent the whatsapp spam~~\n- make much more simple way to run this bot for cross platform\n- ~~for command `id` need to add development of the number before and after~~\n- for command `id` add a linear graph better get from https://kawalcovid19.blob.core.windows.net/viz/statistik_harian.html\n- ~~add a new command `jabar` scrape from https://pikobar.jabarprov.go.id/~~\n- add a new command `jkt` scrape from http://corona.jakarta.go.id/\n- add `id info` for much more detail information\n- add `id hotline` for much more detail information\n\n# Referrence\n- This repo is inspired from @mathdroid repo https://github.com/mathdroid/covid-19-api, some of the similiar is credited to @mathdroid\n- Global case data is parsed from [2019 Novel Coronavirus COVID-19 (2019-nCoV) Data Repository by Johns Hopkins CSSE](https://github.com/CSSEGISandData/COVID-19)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk1m0ch1%2Fcovid-19-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fk1m0ch1%2Fcovid-19-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk1m0ch1%2Fcovid-19-api/lists"}