COVID-19 vaccination data at subnational level. To ensure its officiality, the source data is carefully verified.
Additionally, we provide a static API endpoint, which contains the data per country as JSONs. For more details check here.
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.
This project wouldn't be possible without the great resources available online.
|Name of the country.
|Name of the subnational region of the country.
|Date of the observation.
|ISO 3166-1 country codes (XX)
|ISO 3166-2 region codes (XX-YY or XX-YYY).
|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.
|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.
|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 habitants.
people_vaccinated per 100 habitants.
people_fully_vaccinated per 100 habitants.
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.
Install the package:
$ pip install -e .
$ bash scripts/update_all.sh
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.
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.
See documentation (WIP 🚧)
This site or product includes IP2Location™ ISO 3166-2 Subdivision Code which available from https://www.ip2location.com.