Para redações, pesquisadores e equipes Beta aberto · será Pro

API de dados políticos do Brasil

Os mesmos dados do site em JSON: 2 milhões de políticos que disputaram eleições desde 2000, sanções da CGU, pesquisas registradas no TSE, leis federais e o simulador de voto distrital.

Comece em 1 minuto

Entre com sua conta Google e crie uma chave em Minha conta → Chaves da API.
Envie a chave no cabeçalho de cada chamada:

curl -H "Authorization: Bearer rp_SUA_CHAVE" "https://politicos.radardopoder.com/api/v1/pessoas?uf=RJ&cargo=6&eleito=1&desde=2022"

Também aceitamos o cabeçalho X-API-Key. Respostas em JSON UTF-8; listas vêm em {"meta": {total, pagina, limite, paginas}, "dados": [...]}, com até 100 itens por página.

Recursos

Caminho	Parâmetros	O que traz
`GET /api/v1/pessoas`	uf (obrigatório: SP, RJ… ou BR), q, cargo (código), partido, municipio, eleito (1/0), desde (ano), votos_min, limite, pagina	Políticos do estado, os mais votados e já eleitos primeiro.
`GET /api/v1/pessoas/{uf}/{nome}`	—	Um político pelo endereço do perfil (ex.: /pessoas/sp/tabata-amaral), com sanções da CGU e páginas de anúncios na Meta.
`GET /api/v1/sancoes`	uf, desde (AAAA-MM-DD), limite, pagina	Sanções da CGU (CEIS/CNEP) ligadas a políticos, mais recentes primeiro.
`GET /api/v1/pesquisas`	ano, uf (ou BR), cargo, q, propria (1/0), limite, pagina	Pesquisas eleitorais registradas no TSE desde 2012.
`GET /api/v1/pesquisas/{protocolo}`	—	Uma pesquisa, com plano amostral e metodologia (ex.: SP081902026).
`GET /api/v1/leis`	q, tipo (LEI, LCP, EMC, MPV, DEL), situacao, de, ate (anos), limite, pagina	Leis federais, com busca por relevância.
`GET /api/v1/leis/{slug}`	—	Uma lei (ex.: lei-14133-2021).
`GET /api/v1/simulador/{uf}`	—	Simulação da Câmara em 2026: cadeiras por partido, eleitos e distritos em cada sistema.

Códigos de cargo: 1 presidente, 3 governador, 5 senador, 6 deputado federal, 7 deputado estadual, 8 deputado distrital, 11 prefeito, 13 vereador.

Limites e respostas de erro

Por dia, por chave: Gratis 500 · Essencial 2.000 · Pro 20.000 · Equipe 100.000 · o cabeçalho X-RateLimit-Remaining mostra quanto falta.
401 chave ausente ou inválida · 402 recurso fora do plano · 404 não encontrado · 429 limite do dia · 503 base em carga.
Até 5 chaves ativas por conta. Equipes compartilham o plano: cada pessoa cria as próprias chaves.

Uso dos dados

Os dados vêm de fontes públicas (TSE, Câmara, Senado, CGU, CNJ, IBGE, Meta). Ao publicar, cite "Radar do Poder" e a fonte original. O CPF e o título de eleitor não são publicados nem estão na API. Sanções são informação administrativa da CGU, não condenação criminal.