La API Idealista Search devuelve listados inmobiliarios de Idealista. Pase una URL de búsqueda completa y reciba resultados con precio, título, detalles, imagen, agencia y paginación en JSON.
Cuesta 2 créditos por llamada (renderizado navegador). Use Idealista Property con cada URL link para datos completos del inmueble.
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 |
Requerido |
Descripción |
query |
string |
sí |
URL de búsqueda Idealista completa |
| Campo |
Tipo |
Descripción |
link / title / price |
string / integer |
URL inmueble, título, precio |
details[] |
array |
Specs cortas (habitaciones, m², planta) |
picture / currency |
string |
Miniatura, moneda |
listing_company / listing_company_url |
string |
Nombre agencia, URL perfil |
parking_included |
boolean |
Parking incluido |
pagination.current / total_pages |
integer |
Página actual, total páginas |
Solo se aceptan URLs de búsqueda Idealista. La paginación en la URL se respeta.
- Idealista Search (este endpoint) para vista general de listados
- Idealista Property con URL
/inmueble/ para detalle completo
- Monitorizar inventario en venta en España y Europa
- Construir listas de leads con precio, specs y agencia
- Alimentar pipelines de analytics inmobiliario con paginación
- Monitorización de mercado por ciudad y barrio
