Open data: TSE election results by state and municipality

Name: 50mais1 — Brazilian presidential election results by state and municipality, 1989–2026
Creator: 50mais1
License: https://creativecommons.org/licenses/by/4.0/

Every table behind the site, normalized from TSE files, in CSV and Parquet.

License

CC-BY 4.0 — TSE data (Electoral Data Repository), IBGE boundaries. You may copy, redistribute and adapt, including commercially, as long as you credit the source.

Suggested attribution: “50mais1 (50mais1.com.br), from TSE data and IBGE boundaries, CC-BY 4.0”. The bloc taxonomy is editorial and also CC-BY; the site code is closed.

Export generated on 10/25/2026, 10:04 PM GMT-3 · sources and original TSE files

Files

Table	Formats
candidates	CSV (6.1 kB) PARQUET (5.7 kB)
electorate	CSV (3.9 MB) PARQUET (1.3 MB)
lean	CSV (1.8 kB) PARQUET (4.9 kB)
LICENSE.txt	TXT (128 B)
parties	CSV (4.6 kB) PARQUET (4.7 kB)
polls	CSV (7.9 kB) PARQUET (11 kB)
results_mun	PARQUET (2.1 MB)
results_uf	CSV (48 kB) PARQUET (24 kB)
results	CSV (18 MB) PARQUET (1.4 MB)
taxonomy/candidates.yaml	YAML (11 kB)
taxonomy/parties.yaml	YAML (27 kB)
units	CSV (335 kB) PARQUET (71 kB)

UTF-8, comma separated, dot decimal. Parquet files share the same column names.

Data dictionary

Percentages are of valid votes (0–100). margin = right_pct − left_pct in percentage points: positive = right bloc ahead. unit_id: “UF:SP” for a state, “BR” national, “ZZ” abroad, “MUN:{TSE code}” for a municipality.

results_ufOne row per (year, round, state) with bloc totals

Column	Type	Description
year	int	Election year
round	int	Round (1 or 2)
uf	str	State, ZZ (abroad) or BR (national total)
registered, turnout, abstention	int	Registered voters, turnout and abstention
blank, null, valid	int	Blank, null and valid nominal votes for president
left_votes, right_votes	int	Votes summed by bloc
left_pct, right_pct	float	% of valid votes by bloc
margin	float	right_pct − left_pct (pts)
winner_bloc	str	left or right

resultsVotes per candidate and unit (municipality, state, ZZ, BR)

Column	Type	Description
year, round	int	Year and round
unit_id	str	UF:SP, BR, ZZ or MUN:{TSE code}
candidate_id	str	{year}-{number}, e.g. 2022-13
party_code	str	Party code as printed by the TSE that year
votes	int	Valid nominal votes

electorateElectorate and vote totals per unit and round

Column	Type	Description
year, round, unit_id		Key
registered, turnout, abstention	int	Registered, turnout, abstention
blank, null, valid	int	Blank, null and valid

unitsGeographic units

Column	Type	Description
unit_id	str	Identifier
uf	str	State code
ibge_code, tse_code	int	IBGE (7-digit for municipalities) and TSE codes
name, region	str	Name and region (N, NE, CO, SE, S, EX)
is_municipality	bool	True for municipalities

candidatesPresidential candidates with bloc and strength

Column	Type	Description
id, year, nr		Identifier, year and ballot number
name, party_code	str	Ballot name and party
bloc	str	left or right (editorial taxonomy, see Methodology)
strength	int	1–3: how clearly the candidate belongs to the bloc

partiesParties by era, with bloc and strength

Column	Type	Description
code, name	str	Code and name
bloc, strength		Bloc and strength (1–3)
valid_from, valid_to	int	Era in which the classification applies (empty valid_to = current)

pollsPolls registered with the TSE for the 2026 runoff

Column	Type	Description
id, institute, tse_registration, source_url	str	Identification and source
field_start, field_end, n		Field dates and sample size
lula_pct, flavio_pct, undecided_pct, blank_null_pct	float	Published percentages
population	str	total or valid: base of the percentages
verified	bool	Row checked against the original release

leanLean index by state

Column	Type	Description
uf, name, region	str	Unit
lean_index	float	Weighted mean (state margin − national margin) over the last 4 runoffs; positive = right
rating	str	solid/likely/lean _left\|_right or tossup
electorate_share	float	% of national valid votes
is_swing	bool	Swing state