Aller au contenu principal
Piloterr
Retour à la bibliothèque

API Idealista Search

Récupérez biens Idealista par URL de recherche : prix, specs, agence et pagination. Rendu navigateur, 2 crédits.

Actif2 crédits = 1 requêteGET/v2/idealista/search

Vue d'ensemble de l'endpoint

Documentation détaillée, tarifs et exemples d'utilisation.

Vue d'ensembleLink to Vue d'ensemble

L'API Idealista Search retourne des annonces immobilières depuis Idealista. Passez une URL de recherche complète et recevez résultats avec prix, titre, détails, image, agence et pagination en JSON.

Coûte 2 crédits par appel (rendu navigateur). Utilisez Idealista Property avec chaque URL link pour les données complètes du bien.

Démarrage rapideLink to Démarrage rapide

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/

ParamètresLink to Paramètres

Paramètre Type Requis Description
query string oui URL de recherche Idealista complète

Réponse (results[])Link to Réponse (results[])

Champ Type Description
link / title / price string / integer URL bien, titre, prix
details[] array Specs courtes (chambres, m², étage)
picture / currency string Miniature, devise
listing_company / listing_company_url string Nom agence, URL profil
parking_included boolean Parking inclus
pagination.current / total_pages integer Page actuelle, total pages

Seules les URLs de recherche Idealista sont acceptées. La pagination dans l'URL est respectée.

Processus IdealistaLink to Processus Idealista

  1. Idealista Search (cet endpoint) pour vue d'ensemble des annonces
  2. Idealista Property avec URL /inmueble/ pour détail complet

Cas d'utilisation principauxLink to Cas d'utilisation principaux

  • Surveiller inventaire à vendre en Espagne et Europe
  • Construire listes de leads avec prix, specs et agence
  • Alimenter pipelines analytics immobilier avec pagination
  • Veille marché par ville et quartier

API associées

Étendez vos capacités data avec ces outils complémentaires.

Prêt à commencer ?

Votre API de scraping web est à un clic. Commencez avec +500 crédits, sans infrastructure à gérer, sans proxies à configurer, et sans carte bancaire.

  • +500 crédits
  • Aucune carte bancaire requise
  • Tous les endpoints inclus