# Endereços e CEPs Fonte: IBGE — CNEFE 2022. Comece em https://api.pontofato.com/enderecos/index.json. Siga itens[].url, links.pai e links.proximo; não enumere IDs nem invente caminhos. Cada página traz até 20 itens. Listas de empresas e compras incluem itens[].dados: use o lote antes de abrir cada ficha. Endereços incluem complemento, cod_unico_endereco e nv_geo_coord conforme o CNEFE 2022. Use /index.md para Markdown, /index.okf.md para OKF ou / para HTML no mesmo nó. O cursor depois pertence ao recorte e é opaco. Não representa snapshot de uma base mutável. X-Robots-Tag informa a política de indexação. O header Link rel=canonical aponta para o HTML equivalente, preservando o cursor; links.json continua sendo a referência estruturada para agentes. Os dados estão sob a licença ODbL 1.0 (https://opendatacommons.org/licenses/odbl/1-0/). Ao reutilizar ou citar, credite PontoFato com o link da página; a base derivada publicada segue a mesma licença. O campo atribuicao de cada nó traz o nome, o link, a licença e o texto de crédito com a fonte original. Uso intensivo: Avalie com 1.000 leituras por agente e produto durante 30 dias, usando X-Agent-Pass persistente. A avaliação não renova. Leituras anônimas têm franquia diária por IP. User-Agent informa finalidade declarada, nunca o dono da cota. O acesso pago a metadados custa US$0,10 por 1.000 leituras compartilhadas; documentos, OCR e IA têm preços próprios. Páginas HTML são gratuitas para pessoas, sem cadastro nem franquia de API. Robôs leem as páginas HTML grátis até 1 página por segundo, por família de robô e por site; acima disso, a resposta oferece os dados pagos ou pede ao buscador que espere. JSON, Markdown, OKF e chamadas MCP de dados seguem a franquia e a cobrança da API. Robôs de busca verificados pelo IP que o próprio buscador publica (Googlebot, Bingbot e Applebot) leem fora da franquia, com freio por minuto que responde 429. Franquia de 60 leituras por minuto por agente registrado; sem X-Agent-Pass, por IP e até 1.000 por dia e produto. Excesso devolve 402 com compra ou espera; capacidade continua sujeita a 429/503. Até 20 itens por página; siga links.proximo. Total e contadores da trilha/categorias representam o recorte indexado, na unidade informada; filhos conta categorias imediatas. Na TV, programas são ocorrências nas grades arquivadas. A hierarquia e os totais são preparados separadamente no c3, com atualização manual e incremental; detalhes são lidos na fonte. Respeite Retry-After em 429 ou 503. Compra e instruções em https://radar-cnpj.com/api/acesso. Envie o crédito pré-pago em X-Credito (ou Authorization: Bearer cred_…) nas leituras: depois da franquia, ele compra 1.000 leituras por US$0,10, um pacote por vez. O passe em X-API-Pass também vale. X-API-Credits-Remaining informa os créditos restantes. GET https://api.pontofato.com/enderecos/api/uso com o mesmo passe consulta o saldo sem consumir crédito. Cliente ES module: https://radar-cnpj.com/api-access-client.js. read(url, {buy:true}) precisa de orçamento e carteira do chamador; guarda passe/prova e retoma a leitura. Sem buy:true nunca compra. 402 oferece compra; 401 recusa passe inválido; 409 pede conferir a chave de idempotência. GET e HEAD não coletam nem alteram os dados de origem. 400: entrada inválida; 404: nó ausente; 405: método não aceito; 421: host desconhecido; 429: limite de capacidade; 503: fonte indisponível. Em 429/503 respeite Retry-After. - [Árvore](https://api.pontofato.com/enderecos/index.json) - [OpenAPI](https://api.pontofato.com/enderecos/openapi.json) - [MCP](https://api.pontofato.com/enderecos/mcp): tools/list e tools/call, ferramenta navegar(caminho, depois). - [Mapa OKF](https://api.pontofato.com/enderecos/okf/index.md) - [llm.txt](https://api.pontofato.com/enderecos/llm.txt) ## Exemplo MCP ```sh ORIGIN='https://api.pontofato.com/enderecos' curl -fsS "$ORIGIN/mcp" -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"navegar","arguments":{"caminho":"/"}}}' ``` ## Como consultar Consulte CEPs e endereços observados pelo IBGE no CNEFE 2022, com município e coordenadas disponíveis. Estado → município → bairro/localidade → rua → endereços Avalie com 1.000 leituras por agente e produto durante 30 dias, usando X-Agent-Pass persistente. A avaliação não renova. Leituras anônimas têm franquia diária por IP. User-Agent informa finalidade declarada, nunca o dono da cota. O acesso pago a metadados custa US$0,10 por 1.000 leituras compartilhadas; documentos, OCR e IA têm preços próprios. Páginas HTML são gratuitas para pessoas, sem cadastro nem franquia de API. Robôs leem as páginas HTML grátis até 1 página por segundo, por família de robô e por site; acima disso, a resposta oferece os dados pagos ou pede ao buscador que espere. JSON, Markdown, OKF e chamadas MCP de dados seguem a franquia e a cobrança da API. Robôs de busca verificados pelo IP que o próprio buscador publica (Googlebot, Bingbot e Applebot) leem fora da franquia, com freio por minuto que responde 429. Franquia de 60 leituras por minuto por agente registrado; sem X-Agent-Pass, por IP e até 1.000 por dia e produto. Excesso devolve 402 com compra ou espera; capacidade continua sujeita a 429/503. Até 20 itens por página; siga links.proximo. Total e contadores da trilha/categorias representam o recorte indexado, na unidade informada; filhos conta categorias imediatas. Na TV, programas são ocorrências nas grades arquivadas. A hierarquia e os totais são preparados separadamente no c3, com atualização manual e incremental; detalhes são lidos na fonte. Respeite Retry-After em 429 ou 503. Retrato do CNEFE 2022. No DF, localidades podem trazer nomes de RAs; não inventamos divisões ausentes. Não certifica CEP vigente nem contém nomes de moradores. ### Índice do acervo [HTML](https://pontofato.com/enderecos/) · [JSON](https://api.pontofato.com/enderecos/index.json) · [MD](https://api.pontofato.com/enderecos/index.md) · [OKF](https://api.pontofato.com/enderecos/index.okf.md) ```sh curl -fsS 'https://api.pontofato.com/enderecos/index.json' ``` ### Estado: Distrito Federal [HTML](https://pontofato.com/enderecos/uf/DF/) · [JSON](https://api.pontofato.com/enderecos/uf/DF/index.json) · [MD](https://api.pontofato.com/enderecos/uf/DF/index.md) · [OKF](https://api.pontofato.com/enderecos/uf/DF/index.okf.md) ```sh curl -fsS 'https://api.pontofato.com/enderecos/uf/DF/index.json' ``` ### Município: Brasília [HTML](https://pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/) · [JSON](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/index.json) · [MD](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/index.md) · [OKF](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/index.okf.md) ```sh curl -fsS 'https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/index.json' ``` ### Localidade: Planaltina [HTML](https://pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/) · [JSON](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/index.json) · [MD](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/index.md) · [OKF](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/index.okf.md) ```sh curl -fsS 'https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/index.json' ``` ### Logradouro na localidade [HTML](https://pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/rua/edf-condominio-estancia-mestre-darmas-iv-5d64b6ab4686daad/) · [JSON](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/rua/edf-condominio-estancia-mestre-darmas-iv-5d64b6ab4686daad/index.json) · [MD](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/rua/edf-condominio-estancia-mestre-darmas-iv-5d64b6ab4686daad/index.md) · [OKF](https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/rua/edf-condominio-estancia-mestre-darmas-iv-5d64b6ab4686daad/index.okf.md) ```sh curl -fsS 'https://api.pontofato.com/enderecos/uf/DF/cidade/brasilia-3fc9b36d48613cd3/bairro/planaltina-907275909fa5d738/rua/edf-condominio-estancia-mestre-darmas-iv-5d64b6ab4686daad/index.json' ``` ### CEP 70002-900 [HTML](https://pontofato.com/enderecos/uf/DF/cep/70002900/) · [JSON](https://api.pontofato.com/enderecos/uf/DF/cep/70002900/index.json) · [MD](https://api.pontofato.com/enderecos/uf/DF/cep/70002900/index.md) · [OKF](https://api.pontofato.com/enderecos/uf/DF/cep/70002900/index.okf.md) ```sh curl -fsS 'https://api.pontofato.com/enderecos/uf/DF/cep/70002900/index.json' ``` ## Outros acervos - [Endereços e CEPs](https://pontofato.com/enderecos/) - [Licitações e compras públicas](https://editalmd.com/licitacoes/) - [Empresas por CNPJ](https://radar-cnpj.com/empresas/)