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.
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âmetro |
Tipo |
Obrigatório |
Descrição |
query |
string |
sim |
URL de pesquisa Idealista completa |
| 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.
- Idealista Search (este endpoint) para visão geral de listagens
- Idealista Property com URL
/inmueble/ para detalhe completo
- 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
