Documentação
Changelog
Mudanças na API, da mais recente para a mais antiga. Campos novos entram sem mudar o prefixo /v1; uma mudança incompatível seria uma nova versão, anunciada aqui antes.
2026-11-17 — Ficha sem o campo `description`
A ficha (GET /v1/kondos/{slug}, GET /v1/demo/kondos/{slug} e a ferramenta MCP get_kondo) deixou de trazer o campo description. Ele reproduzia o texto da página de origem, que pertence a quem o escreveu; os fatos do condomínio continuam nos demais campos. Uma descrição própria, escrita a partir dos campos estruturados, pode voltar em uma versão futura.
2026-10-19 — Servidor MCP
Assistentes de IA (Claude, Cursor e outros clientes MCP) podem consultar o catálogo como ferramentas, em POST /mcp. Veja MCP.
- Ferramentas:
list_stateselist_cities(não contam consulta),search_kondoseget_kondo(contam, como a busca e a ficha da API). - Sem chave, a demonstração (5 consultas por dia por IP); com chave,
Authorization: Bearer kd_live_…e a cota da chave. O saldo é o mesmo da API REST.
2026-10-19 — v1
A primeira versão pública da API de dados de condomínios.
- Demonstração sem chave:
GET /v1/demo/kondoseGET /v1/demo/kondos/{slug}, 5 consultas por dia por IP, 10 por página, 2 páginas por busca. Também no simulador. - Listas de referência:
/v1/states,/v1/cities,/v1/amenitiese/v1/builders, sem chave e sem custo, com cache de 10 minutos. - Chaves de API no console:
Authorization: Bearer kd_live_…, até 5 chaves ativas por conta, com rotação e revogação.GET /v1/memostra a chave e o plano. - Busca e ficha com chave:
GET /v1/kondos(resumo, com filtro deuf,cityounearobrigatório, e paginação por cursor assinado de 10 minutos) eGET /v1/kondos/{slug}(registro completo, com procedência). - Cota diária por chave (50 consultas no plano Grátis), renovada à meia-noite de São Paulo, com os cabeçalhos
X-Quota-Limit,X-Quota-RemainingeX-Quota-Reset, e limite de 30 requisições por minuto. - Erros em
application/problem+jsoncomcodeestável, e o contrato em OpenAPI emGET /v1/openapi.json, que gera a referência.