Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de Idealista Search

Obtenga inmuebles Idealista por URL de búsqueda: precio, specs, agencia y paginación. Renderizado navegador, 2 créditos.

Activo2 créditos = 1 solicitudGET/v2/idealista/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

Descripción generalLink to Descripción general

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.

Inicio rápidoLink to Inicio 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 Requerido Descripción
query string URL de búsqueda Idealista completa

Respuesta (results[])Link to Respuesta (results[])

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.

Flujo IdealistaLink to Flujo Idealista

  1. Idealista Search (este endpoint) para vista general de listados
  2. Idealista Property con URL /inmueble/ para detalle completo

Casos de uso principalesLink to Casos de uso principales

  • 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

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos