Subnational COVID-19 vaccination data

API | Download data | GitHub

refresh GitHub last commit Website link! API link!

Follow @sociepy Star Fork

COVID-19 vaccination data at subnational level. To ensure its officiality, the source data is carefully verified.

All country data can be found in a single csv file. If you are interested in indiviual country data, you may want to check countries folder.

Additionally, we provide a static API endpoint, which contains the data per country as JSONs. For more details check here.

Thanks to

This project is inspired by wonderful project owid/covid-19-data, adopting some of its structure, and is open to integration if deemed appropriate. In addition, thanks to all of the people involved in the different source data initiatives.

Content

Data sources

This project wouldnโ€™t be possible without the great resources available online.

Country Source 2-Dose Last update
๐Ÿ‡ฆ๐Ÿ‡บ Australia https://covidlive.com.au/report/vaccinations โŒ 2021-03-08
๐Ÿ‡น๐Ÿ‡ท Turkey https://covid19asi.saglik.gov.tr/ โœ… 2021-03-08
๐Ÿ‡ฆ๐Ÿ‡ท Argentina http://datos.salud.gob.ar/dataset/vacunas-contra-covid-19-dosis-aplicadas-en-la-republica-argentina โœ… 2021-03-07
๐Ÿ‡ท๐Ÿ‡บ Russia https://gogov.ru/articles/covid-v-stats โœ… 2021-03-07
๐Ÿ‡ง๐Ÿ‡ท Brazil https://github.com/wcota/covid19br/ โœ… 2021-03-07
๐Ÿ‡ฑ๐Ÿ‡ง Lebanon https://impact.cib.gov.lb/home/dashboard/vaccine โŒ 2021-03-07
๐Ÿ‡จ๐Ÿ‡ฑ Chile https://github.com/juancri/covid19-vaccination/ โœ… 2021-03-07
๐Ÿ‡ต๐Ÿ‡ช Peru https://gis.minsa.gob.pe/GisVisorVacunados/ โŒ 2021-03-07
๐Ÿ‡บ๐Ÿ‡ธ United States https://github.com/youyanggu/covid19-cdc-vaccination-data โœ… 2021-03-07
๐Ÿ‡ฎ๐Ÿ‡น Italy https://github.com/italia/covid19-opendata-vaccini/ โœ… 2021-03-07
๐Ÿ‡ง๐Ÿ‡ช Belgium https://covid-vaccinatie.be/en โœ… 2021-03-06
๐Ÿ‡ฌ๐Ÿ‡ง United Kingdom https://coronavirus.data.gov.uk/details/download โœ… 2021-03-06
๐Ÿ‡ซ๐Ÿ‡ฎ Finland https://piikki.juiciness.io/ โœ… 2021-03-06
๐Ÿ‡ฎ๐Ÿ‡ณ India https://india-covid19vaccine.github.io โœ… 2021-03-06
๐Ÿ‡ซ๐Ÿ‡ท France https://www.data.gouv.fr/fr/datasets/donnees-relatives-aux-personnes-vaccinees-contre-la-covid-19-1/ โœ… 2021-03-06
๐Ÿ‡ฉ๐Ÿ‡ฐ Denmark https://covid19.ssi.dk/overvagningsdata/vaccinationstilslutning โœ… 2021-03-06
๐Ÿ‡จ๐Ÿ‡ฟ Czechia https://onemocneni-aktualne.mzcr.cz/api/v2/covid-19/ โœ… 2021-03-06
๐Ÿ‡จ๐Ÿ‡ฆ Canada https://github.com/ccodwg/Covid19Canada โœ… 2021-03-06
๐Ÿ‡ฆ๐Ÿ‡น Austria https://info.gesundheitsministerium.gv.at/ โœ… 2021-03-06
๐Ÿ‡ณ๐Ÿ‡ด Norway https://www.fhi.no/sv/vaksine/koronavaksinasjonsprogrammet/koronavaksinasjonsstatistikk/ โœ… 2021-03-05
๐Ÿ‡ช๐Ÿ‡ธ Spain https://github.com/civio/covid-vaccination-spain/ โœ… 2021-03-05
๐Ÿ‡ฉ๐Ÿ‡ช Germany https://github.com/mathiasbynens/covid-19-vaccinations-germany/ โœ… 2021-03-05
๐Ÿ‡ธ๐Ÿ‡ฐ Slovakia https://github.com/Institut-Zdravotnych-Analyz/covid19-data/ โœ… 2021-03-04
๐Ÿ‡ฎ๐Ÿ‡ธ Iceland https://e.infogram.com/c3bc3569-c86d-48a7-9d4c-377928f102bf โœ… 2021-03-04
๐Ÿ‡จ๐Ÿ‡ญ Switzerland https://github.com/rsalzer/COVID_19_VACC/ โœ… 2021-03-03
๐Ÿ‡ธ๐Ÿ‡ช Sweden https://www.folkhalsomyndigheten.se/smittskydd-beredskap/utbrott/aktuella-utbrott/covid-19/vaccination-mot-covid-19/statistik/statistik-over-registrerade-vaccinationer-covid-19/ โœ… 2021-02-28
๐Ÿ‡ต๐Ÿ‡ฑ Poland https://www.gov.pl/web/szczepimysie/raport-szczepien-przeciwko-covid-19 โœ… 2021-02-11

Data format

The data pretends to resemble the API proposed by owid/covid-19-data. Find below the field description, mainly provided by OWID.

Field Description
location Name of the country.
region Name of the subnational region of the country.
date Date of the observation.
location_iso ISO 3166-1 country codes (XX)
region_iso ISO 3166-2 region codes (XX-YY or XX-YYY).
total_vaccinations Total number of doses administered. This is counted as a single dose, and may not equal the total number of people vaccinated, depending on the specific dose regime (e.g. people receive multiple doses). If a person receives one dose of the vaccine, this metric goes up by 1. If they receive a second dose, it goes up by 1 again.
people_vaccinated Total number of people who received at least one vaccine dose. If a person receives the first dose of a 2-dose vaccine, this metric goes up by 1. If they receive the second dose, the metric stays the same.
people_fully_vaccinated Total number of people who received all doses prescribed by the vaccination protocol. If a person receives the first dose of a 2-dose vaccine, this metric stays the same. If they receive the second dose, the metric goes up by 1.
total_vaccinations_per_100 total_vaccinations per 100 habitants.
people_vaccinated_per_100 people_vaccinated per 100 habitants.
people_fully_vaccinated_per_100 people_fully_vaccinated per 100 habitants.

Note: for people_vaccinated and people_fully_vaccinated we are dependent on the necessary data being made available, so we may not be able to make these metrics available for some countries.

Contribute

The updates are done using update_all.sh script. For more details on the scripts being used, check here.

Set up environment

Install the package:

$ pip install -e .

Execute update

$ bash scripts/update_all.sh

Add new countries

New: Use this notebook as a guideline on how to add a new country scraper!

If you know of any reference publishing vaccination regional data for other countries, your contribution is very much appreciated! It is extremely helpfull if you could report this in the issues. Also, if you feel like automating it by yourself (thatโ€™d be awesome!), please fork this repository and issue a pull request with your changes.

The country scraping logic lives within the package module, specifically in covid_updater.scraping. More details to be added here soon.

Bugs

We do our best to ensure that the data is reliable. However, as the project grows and source website change their format, some bugs might appear. If you detect any, please report this in the issues section.

Documentation

See documentation (WIP ๐Ÿšง)

License

See LICENSE.

This site or product includes IP2Locationโ„ข ISO 3166-2 Subdivision Code which available from https://www.ip2location.com.