Skip to content
This repository has been archived by the owner on Dec 17, 2021. It is now read-only.

sociepy/covid19-vaccination-subnational

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Subnational COVID-19 vaccination data

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