BitBusca › Desenvolvedores › API de imóveis (cadastro municipal)
A ficha do lote pela API, direto do cadastro da prefeitura
Busque o imóvel por endereço ou código na cidade e receba a ficha do cadastro da prefeitura: áreas, valor venal, zoneamento e uso. O cadastro é municipal, então a cidade vai no caminho da chamada.
Hoje: Corretor pedindo certidão ou indo à prefeitura para saber área, zoneamento e valor venal do lote. Com a API: Endereço ou código entram; a ficha do cadastro municipal volta em JSON, nas cidades atendidas.
5 créditos por ficha · escopo imoveis · a partir do Builder · planos a partir de R$ 19,90/mês. Chave de teste grátis.
Onde funciona
O cadastro imobiliário é municipal. Hoje a API cobre as cidades abaixo — outras cidades em breve. GET /v1/imovel/cidades devolve a lista viva e o que cada uma publica; Campo Grande é a mais completa.
Campo Grande · Goiânia · Aparecida de Goiânia · Fortaleza · Dourados · Cascavel · Foz do Iguaçu — outras cidades em breve.
Ficha de um lote
curl https://api.bitbusca.net/api/v1/imovel/campo-grande/0000000000 \
-H "Authorization: Bearer $BITBUSCA_API_KEY"{
"tipo": "IMOVEL",
"consulta": "0000000000",
"custo": 5,
"dados": {
"cidade": "Campo Grande/MS",
"bairro": "CENTRO",
"areaTerreno": 360.0,
"areaConstruida": 180.5,
"valorVenal": 254300.00,
"zona": "Z3",
"uso": "Residencial"
}
}Exemplo fictício, formato resumido. Referência completa: OpenAPI.
Por que integrar
- A ficha do lote — Áreas, valor venal, zoneamento e uso, do cadastro da prefeitura.
- Área e zoneamento — O tamanho do terreno e o que pode ser feito nele.
- 7 cidades hoje — A lista de cidades e a busca por endereço não gastam créditos. Outras cidades em breve.
- Paga só o que encontra — 5 créditos por ficha. Nada encontrado (404) ou erro do nosso lado não cobra: o débito volta na hora.
Para quem é
- Imobiliárias e portais — Anúncio sem área nem zoneamento. Anúncio completo com o dado do cadastro.
- Incorporadoras — Triagem de terreno feita lote a lote. Zona e área de cada lote pela API.
- Crédito com garantia de imóvel — Imóvel oferecido sem referência de valor. Valor venal do cadastro para conferir a garantia.
O que você recebe
areaTerreno— O tamanho do lote: preço por metro e potencial do terreno.areaConstruida— O que está construído segundo o cadastro.valorVenal— O valor atribuído no cadastro da prefeitura: referência, não avaliação de mercado.zona— O zoneamento: o que a lei deixa fazer no terreno.uso— Residencial, comercial: como o lote está cadastrado.
O que entrega
- Cidades disponíveis e o que cada uma publica
- Busca de imóvel por endereço ou código (não gasta créditos)
- Ficha do lote: áreas, valor venal, zoneamento e uso
Endpoints e custo
GET /v1/imovel/cidades— Cidades cobertas e os recursos de cada uma (grátis)GET /v1/imovel/busca?cidade=&termo=— Busca por endereço ou código (grátis)GET /v1/imovel/{cidade}/{codigo}— Ficha do lote (5 créditos)
Limites e proteção
- Ficha de imóvel só a partir do plano Builder.
- 5 créditos por ficha; a busca e a lista de cidades não gastam créditos.
- O que vem na ficha depende do que cada prefeitura publica.
Casos de uso
- Imobiliárias e portais — Complete o anúncio com área e zoneamento do lote.
- Incorporadoras — Triagem de terrenos por zona e área.
- Crédito com garantia — Confira o valor venal do imóvel oferecido.
Prompt para Lovable, Cursor ou Bolt
Crie uma ficha de imóvel: primeiro liste as cidades com GET /v1/imovel/cidades; o usuário escolhe a cidade e digita o endereço; busque com GET /v1/imovel/busca?cidade=…&termo=… e, ao escolher o resultado, abra a ficha com GET /v1/imovel/{cidade}/{codigo}. Avise que a cobertura é por cidade.
Use a API da BitBusca (base https://api.bitbusca.net/api). A especificação OpenAPI está em https://api.bitbusca.net/api/v1/openapi.json.
Autentique com o cabeçalho "Authorization: Bearer <chave>", lendo a chave da variável de ambiente BITBUSCA_API_KEY.
Nunca coloque a chave no código do navegador: faça as chamadas por uma função de servidor (edge function, API route ou backend).
Trate os erros pelo campo "code" da resposta: 402 NO_CREDITS (sem créditos), 429 RATE (respeite o cabeçalho Retry-After), 429 COTA_DIARIA (teto do dia atingido), 404 NOT_FOUND (mostre "nada encontrado", não é cobrado).
Comece com a chave de teste (bk_test_…), que devolve dados fictícios e não gasta créditos.Perguntas frequentes
Dá para testar sem pagar?
Sim. A chave de teste (bk_test_…) é grátis, não expira com o sandbox e devolve dados fictícios no mesmo formato da produção — dá para montar a tela inteira sem gastar nada. Quando quiser dado real, ative o sandbox: 7 dias com 50 créditos reais, 10 requisições por minuto, 2 chaves e 1 webhook, uma vez por conta.
Minha cidade não está na lista. E agora?
Ainda não cobrimos: o cadastro é municipal e entra cidade a cidade. Outras cidades chegam em breve — GET /v1/imovel/cidades sempre traz a lista atual.
O valor venal é o valor de mercado?
Não. É o valor do cadastro da prefeitura, usado de base para impostos. Serve de referência para negociação e garantia, não substitui avaliação.
Outras APIs
- API de CPF — Cadastro da pessoa física a partir do CPF, em JSON. (1 crédito por CPF)
- API de telefone — Titular e endereço a partir do número com DDD. (1 crédito por número)
- API de busca por nome — Pessoas encontradas pelo nome, com dados para separar homônimos. (1 crédito por busca)
- API de placa — Dados do veículo pela placa ou pelo número do motor. (5 créditos por placa)
- API de CNPJ — Ficha da empresa com quadro de sócios, pelo CNPJ. (1 crédito por CNPJ)
- API de empresas (leads B2B) — Empresas por CNAE, cidade, porte e abertura — leads B2B. (1 crédito por página)
- API de leads de pessoas — Contatos por região, sem CPF e sem repetição, a partir do Scale. (1 crédito a cada 10 contatos, a partir do Scale)
- API de advogados (OAB) — Ficha do advogado pela OAB e busca por nome. (1 crédito por ficha)
- API do DJEN (publicações e prazos) — Publicações por OAB, parte ou processo, monitores e prazos. (1 crédito por página de busca)
- API de licitações (editais abertos) — Editais abertos, itens, análise por IA e alertas. (1 crédito por página)
- Servidor MCP (conector para IAs) — Conector para Claude, ChatGPT, Cursor e outras IAs. (O custo de cada ferramenta é o da rota)
- Webhooks — Eventos assinados com HMAC: intimação, edital, empresa nova. (Sem custo por entrega)