Subnational COVID-19 vaccination data

API | Download data | GitHub

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
• Data format
• JSON Endpoint API
• Contribute
• Documentation (WIP 🚧 )
• License

Data sources

This project wouldn't be possible without the great resources available online.

Data format

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

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

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.