API de Imóveis: 5 APIs para Dados Imobiliários

Quem procura uma API de imóveis quase nunca quer apenas uma lista de apartamentos. O objetivo real costuma ser comparar preço por metro quadrado, acompanhar novos anúncios, enriquecer um CRM imobiliário, montar um portal, encontrar imóveis em leilão ou dar dados atuais a um agente de IA.

Para fazer isso, a aplicação precisa transformar páginas e buscas imobiliárias em campos previsíveis: preço, área, endereço, quartos, vagas, comodidades, anunciante, fotos, URL e data da coleta.

A GeckoAPI oferece APIs para dados imobiliários de cinco fontes relevantes no Brasil:

ZAP Imóveis para anúncios de venda e aluguel
VivaReal para usados, aluguel e lançamentos
Chaves na Mão para buscas e detalhes de imóveis
OLX para imóveis dentro de um universo amplo de classificados
Portal Zuk para imóveis em leilão

Todas usam a mesma rota HTTP e retornam JSON. O que muda é o target, o tipo de extração e os filtros aceitos por cada fonte.

POST https://api.geckoapi.com.br/v1/extract

Este guia compara as APIs imobiliárias disponíveis, explica PLP e PDP, mostra casos de uso e propõe uma arquitetura para coletar, normalizar e usar anúncios de múltiplos portais.

TL;DR: qual API de imóveis escolher?

Necessidade	API indicada	Por quê
Buscar imóveis para venda ou aluguel por cidade	ZAP Imóveis	Busca estruturada por cidade, UF, negócio, preço, área, quartos e coordenadas
Trabalhar com usados e lançamentos	VivaReal	Filtros ricos, empreendimentos, plantas, mídia e estágio de construção
Filtrar anúncios por bairro, comodidades ou anunciante direto	Chaves na Mão	Busca por URL ou filtros amigáveis, incluindo tipo de imóvel e amenidades
Pesquisar imóveis junto a classificados locais	OLX	Busca por categoria, palavra-chave, UF, região, cidade, preço e ordenação
Monitorar leilões imobiliários	Portal Zuk	Lotes, rodadas, descontos, ocupação, modalidade, processo e documentos
Unificar várias fontes	GeckoAPI	Um endpoint, autenticação única e respostas estruturadas para PLP e PDP

Se a prioridade é uma visão ampla do mercado, a melhor resposta normalmente não é escolher apenas um portal. É combinar fontes, preservar a origem de cada anúncio e normalizar os campos necessários ao seu produto.

Veja também a página da API de imóveis e dados imobiliários para uma visão rápida das fontes atendidas.

O que é uma API de imóveis?

Uma API de imóveis é uma interface que permite a um software enviar uma requisição e receber dados imobiliários estruturados. Em vez de uma pessoa abrir um portal, configurar filtros e copiar anúncios para uma planilha, o sistema executa a consulta e processa a resposta em JSON.

O termo, porém, é amplo. No mercado imobiliário, existem pelo menos cinco categorias diferentes de API:

Publicação e distribuição de anúncios: envia o estoque de um CRM ou imobiliária para portais, muitas vezes por feed XML.
Leads e webhooks: entrega contatos, mensagens e eventos gerados nos portais para o CRM.
Extração de listagens públicas: consulta anúncios e páginas públicas para monitoramento, pesquisa e produtos de dados.
Dados cadastrais e territoriais: trabalha com endereço, lote, zoneamento, tributos, matrícula ou registros, conforme a fonte e a permissão disponível.
Avaliação e comparáveis: estima valor com base em imóveis semelhantes, histórico, localização e modelos estatísticos.

A GeckoAPI atua principalmente na terceira categoria: extração estruturada de listagens e detalhes públicos. Ela não publica anúncios, não compra imóveis, não acessa áreas autenticadas e não substitui dados oficiais de cartório, prefeitura ou registro.

Essa distinção evita uma integração errada. Se você quer distribuir o estoque da sua imobiliária, procure o canal de publicação do portal. Se quer analisar oferta pública, acompanhar preços e montar uma base comparável, uma API de extração é o caminho adequado.

APIs imobiliárias disponíveis na GeckoAPI

A mesma rota suporta dois movimentos complementares:

type: "plp" consulta uma página de listagem ou busca
type: "pdp" extrai os detalhes de um anúncio específico

Na prática, PLP funciona como radar e PDP como ficha completa. A tabela abaixo resume a cobertura.

Fonte	Cobertura principal	PLP	PDP	Melhor uso
ZAP Imóveis	Venda e aluguel	Sim	Sim	Busca regional, monitoramento e comparáveis
VivaReal	Venda, aluguel e lançamentos	Sim	Sim	Inventário amplo, empreendimentos e mídia rica
Chaves na Mão	Venda e aluguel	Sim	Sim	Filtros imobiliários, bairro e anunciante direto
OLX	Imóveis e outros classificados	Sim	Sim	Oferta local e anúncios de categorias amplas
Portal Zuk	Leilões de imóveis	Sim	Sim	Oportunidades, rodadas, descontos e documentos

1. API ZAP Imóveis

A API ZAP Imóveis atende buscas de venda e aluguel por cidade e UF. No PLP, é possível combinar businessType com filtros de quartos, banheiros, vagas, preço, área, palavra-chave, página e coordenadas.

O PDP recebe a URL pública do anúncio e pode retornar, conforme a página disponível:

preço, condomínio e IPTU
tipo de negócio e tipo de imóvel
endereço, bairro, cidade e coordenadas
descrição, comodidades e fotos
anunciante e metadados do anúncio
datas de criação e atualização
URL de tour virtual, quando exposta

Consulte a documentação do ZAP Imóveis PLP e do ZAP Imóveis PDP.

2. API VivaReal

A API VivaReal é indicada quando a busca precisa cobrir imóveis usados, aluguel e também lançamentos. O PLP aceita uma URL pública de resultados ou filtros estruturados como localização, tipo de imóvel, amenidades, quartos, vagas, faixa de preço, área, anunciante direto e inclusão de lançamentos.

O PDP é especialmente rico para empreendimentos. Além dos campos básicos, a resposta pode incluir status do anúncio, estágio de construção, plantas, unidades, incorporadora, mídia, vídeos e atributos do imóvel.

Veja os contratos completos do VivaReal PLP e do VivaReal PDP.

3. API Chaves na Mão

A API Chaves na Mão permite consultar páginas de venda e aluguel por URL pública ou por filtros amigáveis. Entre os parâmetros disponíveis estão UF, cidade, bairro, tipo de imóvel, amenidades, quartos, banheiros, vagas, preço, área, ordenação, anunciante direto e lançamentos.

Também é possível informar latitude e longitude em conjunto para filtrar os itens da página pela proximidade calculada a partir da geolocalização exposta no anúncio, no bairro ou na cidade. Como a precisão varia por item, essa filtragem deve ser tratada como aproximação, não como medição cadastral.

Detalhes técnicos: Chaves na Mão PLP e Chaves na Mão PDP.

4. API OLX para imóveis

A OLX cobre imóveis, veículos, eletrônicos e muitas outras categorias. Por isso, a API OLX para imóveis exige que a busca seja bem recortada por URL, categoria, palavra-chave e localização.

O PLP aceita buscas nacionais ou por UF, região e cidade, além de paginação, faixa de preço e ordenação. Os cards podem trazer título, preço, imagens, localização, propriedades do anúncio e data de publicação.

No PDP, a estrutura depende da categoria do anúncio. A GeckoAPI aplica hash a nome e telefones do anunciante quando esses dados aparecem, reduzindo a exposição de dados pessoais no retorno. Ainda assim, quem controla a integração continua responsável pela finalidade, retenção e segurança do tratamento.

Leia a documentação da OLX PLP e da OLX PDP.

5. API Portal Zuk para leilões de imóveis

A API Portal Zuk cobre uma etapa diferente do mercado: imóveis em leilão. A busca pode ser filtrada por localização, tipo de imóvel, vendedor, ocupação, modalidade, desconto mínimo, possibilidade de parcelamento, quartos, vagas, preço, área e ordenação.

O PDP de um lote pode incluir:

rodadas, datas, lances e valores
percentual de desconto
situação de ocupação
vendedor e modalidade do leilão
matrícula e número de processo, quando expostos
condições de pagamento e visitação
imagens e links de documentos

Como leilão envolve riscos jurídicos e financeiros próprios, os dados da API servem para descoberta e triagem. A decisão de compra exige análise independente do edital, da matrícula, do processo, da ocupação e das condições do lote.

Consulte Portal Zuk PLP e Portal Zuk PDP.

PLP e PDP: como montar uma coleta imobiliária

Uma integração robusta separa descoberta e enriquecimento.

Etapa 1: descobrir anúncios com PLP

O PLP responde perguntas de mercado:

Quais apartamentos de dois quartos estão anunciados neste bairro?
Quantos imóveis aparecem em determinada faixa de preço?
Quais lotes de leilão têm desconto acima de 30%?
Que anúncios novos entraram desde a última coleta?

Exemplo de busca no ZAP Imóveis:

curl -X POST \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "zapimoveis.com.br",
    "type": "plp",
    "city": "Curitiba",
    "state": "PR",
    "businessType": "sale",
    "bedrooms": [2, 3],
    "priceMin": 450000,
    "priceMax": 900000,
    "areaMin": 60,
    "areaMax": 140,
    "page": 1
  }' \
  https://api.geckoapi.com.br/v1/extract

Etapa 2: enriquecer cada URL com PDP

O PDP responde perguntas sobre um anúncio:

Qual é o preço atual e quais despesas aparecem?
Qual é a área, o número de quartos e as comodidades?
Quem publicou o imóvel?
O anúncio mudou ou saiu do ar?
Quais imagens e detalhes estão disponíveis?

Depois de receber as URLs no PLP, envie cada uma ao PDP da mesma fonte:

curl -X POST \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "zapimoveis.com.br",
    "type": "pdp",
    "url": "URL_PUBLICA_DO_ANUNCIO"
  }' \
  https://api.geckoapi.com.br/v1/extract

Não é necessário abrir o PDP de todos os resultados em toda execução. Uma estratégia econômica é enriquecer apenas anúncios novos, alterados ou relevantes para a regra de negócio.

Como normalizar dados de vários portais

Cada portal modela imóveis de forma diferente. Um pode usar lista para área e quartos; outro pode fornecer apenas um valor. Endereço completo também pode ser ocultado, aproximado ou ausente.

Crie um schema interno pequeno e preserve o payload original em outra coluna ou objeto. Um modelo inicial pode ser:

{
  "source": "zapimoveis.com.br",
  "sourceListingId": "id-na-fonte",
  "url": "https://...",
  "businessType": "sale",
  "propertyType": "apartment",
  "price": 650000,
  "condominiumFee": 780,
  "areaM2": 82,
  "bedrooms": 3,
  "bathrooms": 2,
  "parkingSpots": 1,
  "address": {
    "state": "PR",
    "city": "Curitiba",
    "neighborhood": "Centro"
  },
  "advertiser": {
    "id": "id-na-fonte",
    "name": "nome-quando-disponivel"
  },
  "amenities": ["balcony", "pool"],
  "imageUrls": ["https://..."],
  "extractedAt": "2026-08-21T12:00:00.000Z"
}

Mapeie os campos em três camadas:

Camada	Exemplos	Regra recomendada
Identidade	fonte, ID, URL	Nunca descarte a origem; use chave composta por fonte e ID
Comparação	preço, área, quartos, bairro	Normalize tipo e unidade, mas preserve `null` quando não houver dado
Evidência	payload bruto, URL, `extractedAt`	Guarde para auditoria, reprocessamento e rastreabilidade

Evite transformar ausência em zero. Um imóvel sem área publicada não tem 0 m²; ele tem área desconhecida. Essa diferença muda médias, filtros e modelos de precificação.

Deduplicação de anúncios imobiliários

O mesmo imóvel pode aparecer em mais de um portal, por mais de uma imobiliária ou até várias vezes na mesma fonte. Deduplicar apenas pelo título produz muitos erros.

Use uma pontuação com sinais combinados:

latitude e longitude aproximadas
bairro, rua ou CEP quando disponíveis
área em m² com tolerância
quartos, banheiros e vagas
faixa de preço
imagens iguais ou visualmente semelhantes
anunciante e descrição
identificador na própria fonte

Mantenha dois conceitos separados:

anúncio, que pertence a uma fonte e a um anunciante
imóvel provável, que pode agrupar vários anúncios relacionados

Essa separação permite acompanhar preço e disponibilidade por anúncio sem afirmar com certeza que duas publicações representam a mesma unidade.

8 usos de uma API para imobiliária e proptech

1. Monitoramento de oferta e preço

Salve snapshots periódicos para medir entrada e saída de anúncios, alteração de preço, tempo aparente em oferta e distribuição por bairro.

2. Comparáveis para avaliação

Selecione imóveis semelhantes por localização, tipologia, área e características. Preço anunciado não é preço de transação, então trate o resultado como sinal de mercado, não como laudo.

3. Portal ou agregador de imóveis

Unifique fontes em uma busca própria, mantendo links e atribuição de origem. A camada normalizada simplifica filtros, enquanto o payload original preserva particularidades.

4. Enriquecimento de CRM imobiliário

Associe anúncios públicos a regiões, faixas de preço e características úteis para segmentação e priorização operacional, sempre dentro de uma finalidade legítima.

5. Inteligência territorial

Conte oferta por bairro, visualize preço pedido por m² e identifique regiões com mudança de composição. Coordenadas aproximadas devem ser sinalizadas na interface.

6. Monitoramento de leilões

Crie alertas por desconto, ocupação, cidade, modalidade, data e valor. Use o PDP para reunir os links necessários à diligência do lote.

7. Agentes e chatbots imobiliários com IA

Um agente pode consultar a API antes de responder: “Quais apartamentos de três quartos até R$ 800 mil aparecem nesta região?”. A resposta deve incluir fonte, URL e momento da coleta para permanecer verificável.

8. BI e data products

Alimente dashboards, data warehouses, mapas, modelos de propensão e rotinas de pesquisa sem prender a aplicação ao HTML de cada portal.

Arquitetura recomendada para produção

Um pipeline de dados imobiliários pode seguir este fluxo:

Defina buscas estáveis por fonte, cidade, negócio e faixa de preço.
Execute PLPs com paginação controlada e registre a consulta usada.
Coloque URLs novas em uma fila para não bloquear a etapa de descoberta.
Consulte PDPs com concorrência limitada, retry com backoff e idempotência.
Normalize campos essenciais e preserve a resposta original.
Deduplicate anúncios sem apagar a relação com cada fonte.
Crie snapshots de preço, status e atributos que podem mudar.
Publique dados com proveniência, timestamp e regras para campos ausentes.

Três cuidados fazem diferença em produção:

Cache: não repita uma extração que ainda atende à janela de atualização do produto.
Observabilidade: salve status HTTP, requestId, executionId, fonte, página e duração.
Controle de volume: distribua páginas e PDPs ao longo do tempo em vez de criar picos desnecessários.

Limites e qualidade dos dados imobiliários

Uma API organiza o que a fonte disponibiliza; ela não corrige automaticamente toda inconsistência do anúncio.

Considere estes limites no produto:

preço pode ser pedido, lance mínimo ou valor atual, dependendo da fonte
condomínio e IPTU podem estar ausentes ou desatualizados
endereço e coordenadas podem ser aproximados por privacidade
área útil, total e privativa não são sempre equivalentes
listas de quartos ou áreas podem representar diferentes unidades de um lançamento
anúncios podem ser pausados, removidos, republicados ou duplicados
o anunciante pode preencher atributos de forma incompleta
contagens de resultados podem mudar entre páginas e horários

Exponha source, url e extractedAt sempre que o usuário precisar auditar a informação. Para decisões financeiras, jurídicas ou de compra, confirme os dados nos documentos e profissionais responsáveis.

Uso responsável, LGPD e termos das fontes

Dados publicamente acessíveis não deixam de exigir responsabilidade. Antes de operar uma API de anúncios de imóveis:

defina a finalidade do tratamento
colete apenas os campos necessários
evite usar dados pessoais para contato indiscriminado
aplique retenção, controle de acesso e segurança
respeite direitos dos titulares quando aplicáveis
revise termos das fontes e requisitos contratuais do seu caso
não tente contornar login, CAPTCHA ou controles de acesso

A GeckoAPI trabalha com páginas públicas e aplica proteções específicas em alguns endpoints, mas a responsabilidade pelo uso final permanece com quem controla a aplicação. Consulte a página de uso responsável e envolva assessoria jurídica quando o projeto tiver risco regulatório relevante.

Como começar com uma API de dados imobiliários

Escolha uma fonte e um caso de uso pequeno.
Crie uma conta no dashboard da GeckoAPI.
Gere a chave de API e mantenha-a apenas no servidor.
Teste um PLP com uma página e poucos filtros.
Abra um dos resultados com o PDP correspondente.
Defina seu schema normalizado antes de adicionar novas fontes.
Implemente cache, deduplicação e monitoramento.

O teste começa com 100 créditos iniciais, sem cartão. O consumo varia conforme o endpoint e aparece na documentação.

Perguntas frequentes sobre API de imóveis

Existe API de imóveis grátis?

A GeckoAPI oferece 100 créditos iniciais para validar a integração sem cartão. Os créditos são para teste inicial; as condições de continuidade e o custo de cada endpoint aparecem na documentação e na página de preços.

Existe uma API única para todos os imóveis do Brasil?

Não existe uma fonte única que represente todo o mercado. Portais, leiloeiros, CRMs, cadastros públicos e registros cobrem entidades diferentes. Para análise de anúncios, combine fontes e preserve a proveniência de cada item.

Qual é a diferença entre API imobiliária e API para imobiliária?

“API imobiliária” pode significar dados de imóveis, publicação de estoque, leads, CRM, avaliação ou registros. Defina primeiro a ação desejada. A GeckoAPI é voltada à extração estruturada de buscas e anúncios públicos.

A API retorna preço por metro quadrado?

Quando preço e área estão disponíveis, sua aplicação pode calcular preço / área. Antes, escolha a área correta — útil, total ou privativa — e trate lançamentos com múltiplas unidades separadamente.

Posso buscar imóveis por latitude e longitude?

ZAP Imóveis e Chaves na Mão aceitam coordenadas em seus PLPs, com regras descritas na documentação. VivaReal também aceita latitude e longitude na busca estruturada. A precisão final depende do nível de localização publicado em cada anúncio.

Posso usar a API para alimentar um chatbot imobiliário?

Sim. O chatbot pode transformar a pergunta do usuário em filtros de PLP, enriquecer resultados selecionados com PDP e responder com preço, características, fonte, link e data da consulta. Mantenha a chave no backend e nunca peça ao modelo para inventar campos ausentes.

A API substitui avaliação, matrícula ou diligência jurídica?

Não. Dados de anúncios ajudam em pesquisa e triagem, mas não substituem laudo de avaliação, certidão, matrícula atualizada, análise do edital ou aconselhamento profissional.

Próximo passo

Uma boa API de imóveis reduz o trabalho de coleta, mas o valor aparece na camada seguinte: normalização, histórico, deduplicação e uma experiência que deixa clara a origem do dado.

Comece por uma cidade, uma fonte e uma hipótese mensurável. Quando o pipeline estiver confiável, adicione novos portais sem redesenhar toda a aplicação.

Teste a integração com 100 créditos iniciais, sem cartão: acessar o dashboard da GeckoAPI. O consumo varia conforme o endpoint e aparece na documentação.