Pular para o conteúdo

APIs abertas · desenvolvedores

Dados públicos tratados, de volta ao público.

Estes endpoints são públicos, sem chave e sem cadastro — os mesmos que o próprio site consome. Pesquisadores, jornalistas e desenvolvedores podem construir em cima. Tudo nesta página é testável agora, com o curl ao lado de cada rota.

GET/civito/api/municipios

Os 5.570 municípios brasileiros — código IBGE, nome e UF. A espinha dorsal territorial de qualquer integração.

curl -s https://www.civito.com.br/civito/api/municipios
{"municipios":[{"cod_ibge":4206702,"nome":"Herval d'Oeste","uf":"SC"}, …]}
GET/api/civito-globo/base

Os 5.570 municípios com coordenadas da sede (lat/lon, IBGE) + a lista das 27 capitais. É o dado que desenha o Globo Vivo da página inicial.

curl -s https://www.civito.com.br/api/civito-globo/base
{"total":5570,"munis":[[1100015,-12.47,-62.27,"Alta Floresta D'Oeste/RO"],…],"capitais":[…]}
GET/api/civito-globo/pulso

O pulso da plataforma, agregado com TTL de 60 s: atividade dos agentes de dados (total, saudáveis, ativos nas últimas 24 h), últimas edições publicadas no feed e estatísticas do grafo de conhecimento.

curl -s https://www.civito.com.br/api/civito-globo/pulso
{"geradoEm":"…","agentes":{"total":150,"ok":148,"ativos24h":45,"ticker":[…]},
 "edicoes":[{"cod":4127700,"nome":"Toledo","uf":"PR","ts":"…","n":32},…],
 "ckg":{"nos":2940191,"arestas":3755128}}
GET/api/feed-entidades

As entidades com feed cívico ativo (cidades e universidades): slug, nome, UF, marca do jornal, total de publicações e data da última atualização.

curl -s https://www.civito.com.br/api/feed-entidades
{"entidades":[{"tipo":"cidade","slug":"abaetetuba","nome":"Abaetetuba","uf":"PA",
 "marca_jornal":"Abaetetuba em Pauta","total_posts":82,…},…]}
GET/api/feed/{slug}

O feed cívico completo de uma entidade (use o slug devolvido por /api/feed-entidades): edições e cards publicados, cada um com sua fonte.

curl -s https://www.civito.com.br/api/feed/abaetetuba
GET/api/public/civito/geo-foco

Foco geográfico aproximado do chamador (país, UF, cidade) por IP — o mesmo usado pelo prólogo do Globo Vivo. O IP não é armazenado nem devolvido. Atribuição obrigatória: "IP Geolocation by DB-IP" (db-ip.com, CC-BY 4.0).

curl -s https://www.civito.com.br/api/public/civito/geo-foco
{"ok":true,"pais":"BR","uf":"MG","cidade":"Ouro Branco","atribuicao":"IP Geolocation by DB-IP"}
GET/sitemap-feed.xml

Sitemap do feed cívico — todas as superfícies públicas de cidade indexáveis, para crawlers e agregadores.

curl -s https://www.civito.com.br/sitemap-feed.xml

Termos de uso honesto

O combinado.

Origem e crédito

Os dados derivam de fontes públicas oficiais (IBGE, DATASUS, PNCP, INEP…) tratadas pela plataforma. Cite “CIVITO — Inteligência Cívica e Territorial” e as fontes primárias; a geolocalização exige o crédito “IP Geolocation by DB-IP”.

Sem SLA — por enquanto

É um serviço aberto e gratuito, com caches curtos e limites de taxa. Não há garantia formal de disponibilidade; se o seu uso precisa de SLA, fale com a gente.

Uso responsável

Nada aqui contém dado pessoal. Raspagem agressiva será limitada. Achou um problema ou quer um endpoint novo? Escreva — a documentação cresce com o uso real.

A interface de código completa — o Civito Tékhne, com chaves, escopos e SDKs — está em desenho (visão). Estas APIs abertas são o primeiro degrau, disponível hoje.