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.
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ètre |
Type |
Requis |
Description |
query |
string |
oui |
URL de recherche Idealista complète |
| 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.
- Idealista Search (cet endpoint) pour vue d'ensemble des annonces
- Idealista Property avec URL
/inmueble/ pour détail complet
- 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
