APIs abertas · desenvolvedores
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.
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"}, …]}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":[…]}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}}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,…},…]}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
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"}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
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”.
É 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.
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.