API InfoSinistro

Dados públicos de sinistros de trânsito (ARTESP, PRF/DATATRAN e SEJUSP-MG) em JSON. Atualizados toda semana.

1. Autenticação

Crie uma conta no painel, abra API no topo da página e gere a sua chave (começa com isk_). Ela aparece uma única vez; se perder, gere outra (a anterior é revogada). Envie a chave em todas as chamadas:

curl -H "X-API-Key: isk_SUA_CHAVE" "https://SEU-DOMINIO/api/v1/resumo?fonte=prf&ano_ini=2024"

Também vale Authorization: Bearer isk_SUA_CHAVE. Limite: 60 requisições por minuto por chave (resposta 429 ao passar).

2. Endpoints

GET`/api/v1/acidentes`

Lista acidentes, do mais recente para o mais antigo, com paginação.

Parâmetro	Descrição
`limite`	Registros por página (1 a 1000, padrão 100).
`pagina`	Página (padrão 1). Máximo de 200.000 registros por consulta; para mais, refine os filtros ou baixe o CSV/Excel no site.

{ "total": 1840, "pagina": 1, "limite": 100, "paginas": 19,
  "itens": [ { "id": 2196557, "fonte": "PRF", "data": "2026-08-26", "hora": "06:00", "uf": "SP",
               "rodovia": "BR-116", "km": "5", "municipio": "GUARULHOS", "tipo": "ATROPELAMENTO DE PEDESTRE",
               "detalhe": "...", "causa": "...", "mortes": 0, "graves": 0, "moderados": 0, "leves": 1,
               "veiculos": "AUTOMÓVEL=1", "categorias": ["PASSEIO / LEVE"], "lat": -23.42, "lon": -46.47 } ] }

GET`/api/v1/resumo`

Totais (acidentes, mortes, feridos) e agregados por ano, mês, hora, tipo, causa, rodovia, município, UF e categoria de veículo.

GET`/api/v1/relatorios/horarios`

Top 5 faixas de horário com mais acidentes. Parâmetro extra: janela (1 a 4 horas, padrão 1).

GET`/api/v1/relatorios/genero`

Pessoas envolvidas por sexo em cada UF (PRF e MG). Filtros: fonte (prf, mg), ano_ini, ano_fim, uf, estado_fisico (MORTO, FERIDO GRAVE, FERIDO LEVE, ILESO), envolvido (CONDUTOR, PASSAGEIRO, PEDESTRE).

GET`/api/v1/meta`

Valores existentes para os filtros (UFs, rodovias, municípios, tipos, causas, anos).

3. Filtros (valem para acidentes, resumo e horários)

Parâmetro	Valores
`fonte`	`artesp`, `prf`, `mg` ou `ambas` (padrão: todas)
`ano_ini`, `ano_fim`	Anos, ex.: `2024`
`data_ini`, `data_fim`	`AAAA-MM-DD`
`uf`, `rodovia`, `municipio`, `tipo`, `causa`, `concessionaria`	Texto exato em maiúsculas, como em `/api/v1/meta`. Repita o parâmetro para vários valores: `uf=SP&uf=MG`
`veiculo`	`CAMINHÃO / CARGA`, `PASSEIO / LEVE`, `MOTOCICLETA`, `ÔNIBUS`, `BICICLETA`, `OUTROS` (repetível)
`veic_modo`	`envolve` (padrão) ou `apenas`
`com_morte`	`1` para só acidentes com morte
`incluir_dup`	`1` para incluir prováveis duplicados entre bases

4. Exemplos

# acidentes com caminhão, na BR-116, em 2025
curl -H "X-API-Key: $CHAVE" -G "https://SEU-DOMINIO/api/v1/acidentes" \
  --data-urlencode "rodovia=BR-116" --data-urlencode "ano_ini=2025" --data-urlencode "ano_fim=2025" \
  --data-urlencode "veiculo=CAMINHÃO / CARGA" --data-urlencode "limite=500"

# Python
import requests
r = requests.get("https://SEU-DOMINIO/api/v1/relatorios/horarios",
                 headers={"X-API-Key": CHAVE}, params={"fonte": "prf", "janela": 2})
print(r.json()["top5"])

5. Erros

Código	Significado
401	Chave ausente, inválida ou revogada.
400	Parâmetro inválido ou paginação além do limite.
429	Limite de requisições por minuto excedido.

6. Avisos sobre os dados

São dados públicos de fontes diferentes, com critérios diferentes. Confira a fonte original antes de decisões críticas.
MG informa só ano e mês (data vem como AAAA-MM) e não traz hora, rodovia ou tipo de acidente.
A PRF só informa coordenadas a partir de 2017. Nenhuma fonte pública traz placa de veículo.
O uso está sujeito aos termos e à política de privacidade.