Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Idealista Search

Obtenha imóveis Idealista por URL de pesquisa: preço, specs, agência e paginação. Renderização navegador, 2 créditos.

Ativo2 créditos = 1 requisiçãoGET/v2/idealista/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

A API Idealista Search devolve listagens imobiliárias do Idealista. Passe uma URL de pesquisa completa e receba resultados com preço, título, detalhes, imagem, agência e paginação em JSON.

Custa 2 créditos por chamada (renderização navegador). Use Idealista Property com cada URL link para dados completos do imóvel.

Início rápidoLink to Início rápido

GET https://api.piloterr.com/v2/idealista/search?query=https://www.idealista.com/venta-viviendas/barcelona/ciutat-vella/la-barceloneta/
GET https://api.piloterr.com/v2/idealista/search?query=https://www.idealista.com/venta-viviendas/madrid-madrid/

ParâmetrosLink to Parâmetros

Parâmetro Tipo Obrigatório Descrição
query string sim URL de pesquisa Idealista completa

Resposta (results[])Link to Resposta (results[])

Campo Tipo Descrição
link / title / price string / integer URL imóvel, título, preço
details[] array Specs curtas (quartos, m², andar)
picture / currency string Miniatura, moeda
listing_company / listing_company_url string Nome agência, URL perfil
parking_included boolean Estacionamento incluído
pagination.current / total_pages integer Página atual, total páginas

Apenas URLs de pesquisa Idealista são aceites. A paginação na URL é respeitada.

Fluxo IdealistaLink to Fluxo Idealista

  1. Idealista Search (este endpoint) para visão geral de listagens
  2. Idealista Property com URL /inmueble/ para detalhe completo

Casos de uso principaisLink to Casos de uso principais

  • Monitorizar inventário à venda em Espanha e Europa
  • Construir listas de leads com preço, specs e agência
  • Alimentar pipelines de analytics imobiliário com paginação
  • Monitorização de mercado por cidade e bairro

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos