# PontoFato > Consulte endereços com coordenadas e empresas no CEP. Endereços com referência em 2022; a consulta não certifica CEP vigente. > Acervo: lotes preservam complemento, cod_unico_endereco e nv_geo_coord. /api/vizinhanca entrega o cruzamento econômico por CEP; consulte a cota para saber se a cobrança está ativa. **Parceria, patrocínio e anúncio** Espaços do produto sob consulta, com preço sugerido em USD por 30 dias, os números públicos ao lado e uma proposta que chega direto a quem responde. - `GET https://staging.pontofato.com/api/partners` — espaços, preço sugerido, carteira e os campos da proposta. - [Enviar proposta](https://staging.pontofato.com/parceria) — a mesma oferta para gente, com o formulário. - `GET https://staging.pontofato.com/okf/parceria.md` — a oferta em markdown, para ler sem parsear JSON. **Acervos públicos de dados** Explore endereços e compras por lugar e abra os registros de que precisa. Até 20 itens por página, em formatos prontos para pessoas e agentes. Confira a cobertura e a data de referência antes de usar um resultado. Cada produto informa suas opções de acesso. - [CEPs e endereços](https://api.pontofato.com/enderecos/index.json): Encontre endereços por lugar, com coordenadas e referência de 2022. Não certifica CEP vigente. UF → município → bairro/localidade → rua → endereços. [HTML](https://api.pontofato.com/enderecos/) · [llms.txt](https://api.pontofato.com/enderecos/llms.txt) · [OKF](https://api.pontofato.com/enderecos/okf/index.md) - [Editais e compras públicas](https://api.editalmd.com/licitacoes/index.json): Encontre compras públicas por lugar e período. Consulte documentos e opções de leitura no EditalMD. Modalidade → UF → ano → mês → dia → município → compras. [HTML](https://api.editalmd.com/licitacoes/) · [llms.txt](https://api.editalmd.com/licitacoes/llms.txt) · [OKF](https://api.editalmd.com/licitacoes/okf/index.md) **Contato agente** - `POST /api/contact` sem captcha → **HTTP 402** x402 **$0.10** USDC. - `GET /api/vizinhanca` está com cobrança desativada, sujeito à capacidade do serviço. **Cota** - Grátis: lookup de CEP, próximo, busca, raio e empresas — sem cota no v1. - Grátis: vizinhança por raio — cobrança desativada; limites de capacidade continuam valendo. - Pago: 1,000 basic reads across /empresas, /enderecos and /licitacoes, valid for 30 days; availability and purchase: GET/POST /api/acesso; no automatic renewal — **$1.00** USDC via x402. - Pago: contato de agente — **$0.10** USDC via x402. - **Sem cobrar agora**: vizinhanca. Chame direto — não vem 402. O preço acima é o de tabela e volta a valer sem aviso. Rota paga → **402** com `accepts[]` (x402) e `credito` (pré-pago, `POST /api/credito?usd=10`, vale em todos os produtos). Pague e repita com `X-PAYMENT`, ou mande `Authorization: Bearer cred_…`. Números em vigor: https://staging.pontofato.com/api/ ## Descoberta - [Integrações e agentes](https://staging.pontofato.com/developers) — comece pelo índice e leia a referência da operação; use HTTP/MCP para dados. - [Índice da API](https://staging.pontofato.com/api/) - [llms.txt](https://staging.pontofato.com/llms.txt) - [llms-full.txt](https://staging.pontofato.com/llms-full.txt) - [OpenAPI](https://staging.pontofato.com/openapi.json) - [MCP](https://staging.pontofato.com/mcp) - [Guia de valor, compra e recuperação](https://staging.pontofato.com/api-access-guide.md): cobertura, limites e orçamento explícito. ## Convenções - Rota de leitura aceita `GET` e também `POST`, `PUT` ou `PATCH` com os mesmos parâmetros em JSON ou formulário. - JSON é o padrão; `Accept: text/html` devolve a mesma resposta em HTML. - `/skill.md` é a skill pronta para agente; `/.well-known/api-catalog` (ou `/discovery/resources`) lista as superfícies; `/mcp` também atende em `/mcp/v1`. ## Endpoints principais - [`GET /api/auth/bootstrap`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Fbootstrap): Prepara o navegador para entrar na conta global. (auth: none) - [`GET /api/account/profile`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fprofile): Consulta seu perfil global. (auth: session) - [`GET /api/account/avatar`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Favatar): Consulta sua foto de perfil global. (auth: session) - [`GET /api/me`](/llms-full.txt?prefix=%2Fapi%2Fme): Lê a conta global atual neste produto. (auth: session) - [`POST /api/auth/logout`](/llms-full.txt?prefix=%2Fapi%2Fauth%2Flogout): Revoga esta sessão do produto. (auth: session) - [`GET /api/account/keys`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys): Lista suas chaves de API neste produto. (auth: session) - [`POST /api/account/keys/create`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys%2Fcreate): Cria uma chave de API para agentes e scripts. (auth: session) - [`POST /api/account/keys/revoke`](/llms-full.txt?prefix=%2Fapi%2Faccount%2Fkeys%2Frevoke): Revoga uma das suas chaves de API. (auth: session) - [`GET /okf/:arquivo`](/llms-full.txt?prefix=%2Fokf%2F%3Aarquivo): Bundle OKF (Open Knowledge Format v0.1): markdown com frontmatter para o agente ler o produto inteiro sem parsear HTML. (auth: none) - [`GET /.well-known/:arquivo`](/llms-full.txt?prefix=%2F.well-known%2F%3Aarquivo): Descoberta de máquina antes da home: `api-catalog` (RFC 9727, linkset com a API e o MCP), `security.txt` (RFC 9116), `x402` (manifesto de pagamento: rede, carteira e rotas que cobram), `agent-card.json` (identidade do agente: ferramentas MCP e portas de descoberta; também em `/agent.json`) e `mcp-registry-auth` (chave do registro oficial de MCP). (auth: none) - [`GET /apis.json`](/llms-full.txt?prefix=%2Fapis.json): APIs.json (apisjson.org, 0.19): o índice que o APIs.io colhe — a API, o MCP, OpenAPI, guia e bundle OKF num arquivo só. Também em `/.well-known/apis.json`. (auth: none) - [`GET /agent.json`](/llms-full.txt?prefix=%2Fagent.json): Cartão do agente: identidade, quem opera, documentação, o endpoint MCP e as ferramentas que ele serve. Mesmo documento de `/.well-known/agent-card.json`. (auth: none) - [`GET /okf/:tipo/:id.md`](/llms-full.txt?prefix=%2Fokf%2F%3Atipo%2F%3Aid.md): O mesmo registro que a API responde, em markdown OKF: `cep` (Endereço do CEP — referência 2022). Via de acesso para quem já tem o id, não catálogo. (auth: none) - [`POST /mcp`](/llms-full.txt?prefix=%2Fmcp): MCP Streamable HTTP — as tools deste catálogo, despachadas neste mesmo Worker. (auth: none) - [`GET /api/cep/:cep`](/llms-full.txt?prefix=%2Fapi%2Fcep%2F%3Acep): Endereços de um CEP, com latitude e longitude. (auth: none) - [`GET /api/cep/:cep/unidades`](/llms-full.txt?prefix=%2Fapi%2Fcep%2F%3Acep%2Funidades): Unidades de um CEP, com complemento, tipo e identificador — paginado. (auth: none) - [`GET /api/proximo`](/llms-full.txt?prefix=%2Fapi%2Fproximo): Endereço mais perto de um par lat/lon. Sem default para (0,0). (auth: none) - [`GET /api/buscar`](/llms-full.txt?prefix=%2Fapi%2Fbuscar): Busca textual de logradouro, com UF e cidade opcionais. (auth: none) - [`GET /api/empresas`](/llms-full.txt?prefix=%2Fapi%2Fempresas): Empresas registradas neste CEP, até 50 por página. (auth: none) - [`GET /api/raio`](/llms-full.txt?prefix=%2Fapi%2Fraio): CEPs a N metros de um ponto, com distância e quantidade de endereços dentro do raio. (auth: none) - [`GET /api/vizinhanca`](/llms-full.txt?prefix=%2Fapi%2Fvizinhanca): Empresas ativas, abertas e baixadas num raio em metros, por CNAE, com as aberturas mais recentes e a distância de cada uma. (auth: credito) - [`GET /api/local`](/llms-full.txt?prefix=%2Fapi%2Flocal): Cidade/UF aproximadas de quem chama. Sem cache. (auth: none) - [`POST /api/pagamento/aberto`](/llms-full.txt?prefix=%2Fapi%2Fpagamento%2Faberto): A interface relata que exibiu uma cobrança. Agentes não devem chamar. (auth: none) - [`GET /api/vitrine`](/llms-full.txt?prefix=%2Fapi%2Fvitrine): Os números públicos do produto: tráfego, agentes, uso e confiabilidade, sem dinheiro. (auth: none) - [`GET /api/vitrine/operador`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Foperador): O documento completo do produto no painel do operador — só com o token do operador. (auth: none) - [`GET /api/vitrine/painel`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Fpainel): O painel da casa inteira, na forma que o gm lê — só com o token do operador. (auth: none) - [`GET /api/vitrine/cursores`](/llms-full.txt?prefix=%2Fapi%2Fvitrine%2Fcursores): O cursor de erro resolvido por produto (`borda`, `cli`) — só com o token do operador. (auth: none) - [`GET /api/partners`](/llms-full.txt?prefix=%2Fapi%2Fpartners): Parceria, patrocínio e anúncio: os espaços do produto com preço sugerido, os números públicos ao lado e como propor. (auth: none) - [`POST /api/visit`](/llms-full.txt?prefix=%2Fapi%2Fvisit): Ping da interface que soma a visita do dia. Agente não precisa chamar. (auth: none) - [`GET /api/metrics`](/llms-full.txt?prefix=%2Fapi%2Fmetrics): Métricas dos últimos 7 dias para o painel do operador; com o token, inclui os pagamentos. (auth: none) - [`POST /api/credito`](/llms-full.txt?prefix=%2Fapi%2Fcredito): Recarrega crédito pré-pago: paga uma vez com x402 e recebe o token que desconta em qualquer API da casa. (auth: none) - [`GET /api/credito`](/llms-full.txt?prefix=%2Fapi%2Fcredito): Saldo e extrato do crédito — as últimas movimentações, sem devolver o token. (auth: credito) - [`GET /api/acesso`](/llms-full.txt?prefix=%2Fapi%2Facesso): Discover the monthly data package or inspect a private purchase. (auth: none) - [`POST /api/acesso`](/llms-full.txt?prefix=%2Fapi%2Facesso): Buy 1000 basic data reads for US$1, valid for 30 days. (auth: none) - [`GET /api/pricing`](/llms-full.txt?prefix=%2Fapi%2Fpricing): Preços vigentes e franquias gratuitas. (auth: none) - [`GET /api/billing`](/llms-full.txt?prefix=%2Fapi%2Fbilling): Descoberta pública de pagamento e crédito pré-pago. (auth: none)