Skip to content

capyvara/brazil-civil-registry-data

Repository files navigation

Brazil Civil Registry Data

Raw scrapings of https://transparencia.registrocivil.org.br/

The idea is that if we minimize the number of people scraping their website, everyone will benefit, so this repo will try to keep fine grained data as possible. Due to the design of their website extracting detailed information may be costly.

If you feel any data you need is missing, please open an issue here.

Notice: This repo is just a copy of the data available at the site and isn't responsible for it, please read their documentation.

Also, the site scrapping is a continuous, incremental and lengthy process, and may introduce additional errors in the data, beware of that when analyzing it.

Tables

civil_registry_xxxxx.csv

Registrations at https://transparencia.registrocivil.org.br/registros

Monthly entries, contains all the reported cities and states, since 2015, there are multiple sub-types, see below.

name type notes
start_date date yyyy-mm-dd
Registration date period start (inclusive)
end_date date yyyy-mm-dd
Registration date period end (inclusive)
state string Registration UF code
state_ibge_code integer Registration state ibge code
city string Registration city name, if empty then deaths_total are state-wise
city_ibge_code integer Registration city ibge code, if empty then deaths_total are state-wise
xxxxx_total integer Total registrations at date
created_at datetime yyyy-mm-dd hh:mm
Approximated time the request to the server was made

civil_registry_deaths.csv

Scrap of all-cause death registrations

civil_registry_births.csv

Scrap of birth certificates registrations

civil_registry_covid_xxxxx.csv

Scrap of natural-cause deaths at https://transparencia.registrocivil.org.br/especial-covid (from Causas Cardiacas)

Notice : The name covid comes from their panel, actually the table contains natural causes, not only covid deaths.

Daily entries, there are multiple sub-types, see below.

name type notes
date date yyyy-mm-dd
Ocurrence date
state string Ocurrence UF code
state_ibge_code integer Ocurrence state ibge code
city string [optional] Ocurrence city name
city_ibge_code integer [optional] Ocurrence city ibge code
place string [optional] place(s) where the deaths occurred, + separated
(hospital, home, public, others)
gender string [optional] F, M
age_group string [optional] age group
(9-, 10-19, 20-29, 30-39, 40-49, 50-59, 60-69, 70-79, 80-89, 90-99, 100+, NA)
deaths_sars integer Number of SARS deaths (SRAG)
deaths_pneumonia integer Number of pneumonia deaths (PNEUMONIA)
deaths_respiratory_failure integer Number of respiratory failure deaths (INSUFICIENCIA_RESPIRATORIA)
deaths_septicemia integer Number of septicemia deaths (SEPTICEMIA)
deaths_indeterminate integer Number of indeterminate deaths (INDETERMINADA)
deaths_others integer Number of others deaths (OUTRAS)
deaths_covid19 integer Number of COVID-19 only deaths (COVID)
deaths_stroke integer Number of stroke deaths (AVC)
deaths_stroke_covid19 integer Number of stroke deaths with COVID-19 (COVID_AVC)
deaths_cardiopathy integer Number of cardiopathy deaths (CARDIOPATIA)
deaths_cardiogenic_shock integer Number of cardiogenic shock deaths (CHOQUE_CARD)
deaths_heart_attack integer Number of heart attack deaths (INFARTO)
deaths_heart_attack_covid19 integer Number of heart attack deaths with COVID-19 (COVID_INFARTO)
deaths_sudden_cardiac integer Number of sudden cardiac arrest deaths (SUBITA)
created_at datetime yyyy-mm-dd hh:mm
approximated time the data was produced according to the server

Notice: On the site, there are some displayed aggregations:

Name Aggregation
COVID-19 deaths_covid19 + deaths_stroke_covid19 + deaths_heart_attack_covid19
Demais óbitos cardiovasculares deaths_cardiopathy + deaths_cardiogenic_shock + deaths_sudden_cardiac

civil_registry_covid_states.csv

Table (no gender nor age group) for all the 27 brazilian states, since 2018

civil_registry_covid_cities.csv

Table (no gender nor age group) for brazilian cities over 100,000 population and capitals (about 317), since 2018

civil_registry_covid_states_detailed.csv

Table (with gender and age group) for all the 27 brazilian states, since 2019

civil_registry_covid_cities_detailed.csv

Table (with gender and age group) for brazilian cities over 500,000 population and capitals (about 56), since 2019

Notice: Normaly the repo is updated daily, except for the detailed scraps that normally is on a weekly basis (they take more than one day to scrap).

Changelog

2021-04-10

  • Added civil_registry_births.csv containing birth certificates
  • In order to improve the scrapping speed, the detailed covid scraps now reuse data from older scraps, it if detect no data change in broader queries (quarter, monthly, etc). So the created_at columns may reflect older dates since no data actually changed and was reused.

2021-01-16

Now includes year 2021

2020-06-26

Added cardiac causes, 7 more columns, from deaths_stroke to deaths_sudden_cardiac, as committed at cd7a6b3

Notice: COVID-19 deaths are now split in three columns (deaths_covid19, deaths_stroke_covid19, deaths_heart_attack_covid19), see table above.

2020-06-21

Fixes #4 by adding capital cities to detailed, as commited at fbef16

2020-06-13

In order to fix #3, the city of "Brasilia" (ibge_code=5300108) now contains the data for the whole state "DF" (ibge_code =53), as committed at a043e3d3

IBGE codes

https://www.ibge.gov.br/explica/codigos-dos-municipios.php

Licensing

Creative Commons Attribution ShareAlike

Please mention the original source and this repo.

More information, special thanks