API Zapimoveis: como extrair listagens e detalhes de imóveis em JSON

Se você precisa acompanhar anúncios de venda e aluguel no Zapimoveis, o ponto principal é transformar páginas públicas em dados que o seu sistema realmente consiga usar: preço, endereço, metragem, fotos, anunciante, características do imóvel e URL do anúncio.

Fazer isso com scraper próprio costuma virar manutenção sem fim. Classes mudam, a navegação muda, o HTML muda e sua rotina quebra no pior momento.

Com a GeckoAPI, o fluxo fica mais simples: você faz uma chamada HTTP e recebe JSON estruturado. No caso do zapimoveis.com.br, existem dois formatos principais de extração:

• PLP para buscar imóveis por cidade, UF e tipo de negócio
• PDP para extrair a ficha completa de um anúncio a partir da URL

Documentação técnica: Zapimoveis PLP e Zapimoveis PDP.

Quando essa API faz sentido

Ela costuma ser útil para equipes que precisam consumir dados imobiliários de forma recorrente:

• Imobiliárias e CRMs que querem enriquecer leads e cadastros
• Portais e comparadores que agregam anúncios de diferentes fontes
• Times de BI e pricing que monitoram preço, metragem e oferta por região
• Produtos com IA que precisam responder com dados reais em vez de texto genérico

Como funciona a busca de imóveis no Zapimoveis

No modo PLP, você informa a região e os filtros da busca. Em vez de mandar uma URL pronta, você envia os parâmetros que descrevem a consulta.

Os campos principais são:

Campo	Obrigatório	Observação
target	Sim	Deve ser zapimoveis.com.br
type	Sim	Use plp
city	Sim	Nome da cidade, como Curitiba
state	Sim	UF com 2 letras, como PR
businessType	Sim	sale ou rent
page	Não	Paginação, começando em 1
keyword	Não	Termo adicional para refinar a busca
Filtros	Não	Quartos, banheiros, vagas, preço e metragem

Filtros comuns:

• bedrooms, bathrooms, parkingSpots
• priceMin e priceMax
• areaMin e areaMax

Exemplo de busca PLP com filtros

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": "rent",
    "bedrooms": [2, 3],
    "bathrooms": [2],
    "priceMin": 1500,
    "priceMax": 3500,
    "areaMin": 55,
    "areaMax": 120,
    "page": 1
  }' \
  https://api.geckoapi.com.br/v1/extract

O retorno dessa chamada serve para listar oportunidades, alimentar dashboards e capturar as URLs dos anúncios que depois você pode processar no modo PDP.

Como extrair a ficha completa de um anúncio

No modo PDP, a entrada é a URL pública do imóvel no zapimoveis.com.br. A API valida o domínio, identifica o anúncio e devolve os dados estruturados daquele imóvel.

Exemplo de extração PDP

curl -X POST \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "target": "zapimoveis.com.br",
    "type": "pdp",
    "url": "https://www.zapimoveis.com.br/imovel/aluguel-apartamento-4-quartos-com-piscina-agua-verde-curitiba-pr-158m2-id-2795564422/"
  }' \
  https://api.geckoapi.com.br/v1/extract

Esse é o modo mais útil quando você precisa de mais contexto por imóvel, como:

• preço e condomínio
• endereço e localização
• fotos e outras mídias
• características do imóvel
• dados do anunciante
• identificadores e metadados do anúncio

Por que usar PLP e PDP juntos

Na prática, os dois modos se complementam:

• o PLP encontra os anúncios de uma região ou faixa de preço
• o PDP aprofunda os dados de cada imóvel
• juntos, eles ajudam a montar uma pipeline estável para monitoramento, CRM e inteligência de mercado

Um fluxo comum é:

1. Buscar imóveis por cidade, UF e filtros.
2. Guardar as URLs retornadas.
3. Enriquecer cada anúncio com uma chamada PDP.
4. Gravar tudo em CRM, data warehouse ou camada analítica.

Boas práticas de implementação

Se você vai integrar essa extração no produto, vale seguir algumas práticas simples:

• Use cache para evitar reprocessar o mesmo anúncio com frequência desnecessária
• Deduplicate por URL ou listingId para não duplicar imóveis na base
• Controle a paginação para manter custo e volume previsíveis
• Normalize cidade, UF e tipo de negócio antes de gravar os dados
• Valide campos nulos ou ausentes no seu pipeline antes de expor os dados ao usuário final

Perguntas frequentes

Existe API oficial pública do Zapimoveis para listagens?

Se o seu objetivo é integrar dados estruturados em um produto, a GeckoAPI resolve esse fluxo com retorno em JSON. Para ambientes enterprise, sempre vale revisar requisitos contratuais, termos de uso e compliance do seu lado.

Posso enviar a URL de uma busca no PLP?

Não nesse formato. No PLP do Zapimoveis, a busca é montada a partir de cidade, UF, businessType e filtros opcionais, como explicado na documentação PLP.

Quando faz sentido usar só o PDP?

Quando você já tem a URL do anúncio e quer apenas enriquecer esse imóvel com dados completos, sem passar antes pela listagem.

Como começar

1. Crie sua conta no dashboard da GeckoAPI
2. Gere sua chave de API
3. Teste uma chamada plp
4. Teste uma chamada pdp
5. Conecte a resposta ao seu CRM, BI ou pipeline de automação

---

Teste com 1000 requisições grátis por mês: dashboard.geckoapi.com.br.