Aller au contenu principal
État du réseau
Se connecter
Piloterr
Retour à la bibliothèque

API Idealista Provinces

Renvoie les 50 provinces espagnoles qu'Idealista liste pour les logements à vendre. Chaque ligne a un slug stable, le nom, la communauté autonome, le nombre d'annonces et l'URL de recherche.

Actif3 crédits = 1 requêteGET/v2/idealista/provinces
Essayer l'endpoint gratuitementPiloterr

Vue d'ensemble de l'endpoint

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

Vue d'ensembleLink to Vue d'ensemble

Renvoie les 50 provinces espagnoles qu'Idealista liste pour les logements à vendre. Chaque ligne a un slug stable, le nom, la communauté autonome, le nombre d'annonces et l'URL de recherche.

Passez results[].url comme query à /v2/idealista/search. Cet endpoint n'a aucun paramètre.

Démarrage rapideLink to Démarrage rapide

La liste complète:

GET https://api.piloterr.com/v2/idealista/provinces

Madrid, puis ses annonces. Le slug est madrid-provincia.

GET https://api.piloterr.com/v2/idealista/search?query=https://www.idealista.com/venta-viviendas/madrid-provincia/

ParamètresLink to Paramètres

Aucun paramètre. La liste vient de la page d'accueil espagnole et couvre les logements à vendre. Le tableau contient 50 provinces.

Champs de réponseLink to Champs de réponse

Champ Type Description
results array 50 provinces, dans l'ordre Idealista
results[].slug string Slug stable, par exemple madrid-provincia
results[].name string Nom. Madrid s'appelle Madrid
results[].url string URL de recherche vente. À passer dans query de la recherche
results[].region string Communauté autonome
results[].listing_count integer Nombre de logements à vendre affiché

Pas de pagination. Le nombre d'annonces change. L'URL de Madrid reste https://www.idealista.com/venta-viviendas/madrid-provincia/.

Cas d'usageLink to Cas d'usage

  • Remplir un menu de provinces, puis appeler la recherche avec l'url choisie
  • Conserver le slug et réutiliser la même URL

Codes d'erreurLink to Codes d'erreur

Code Signification
401 Clé API manquante
403 Idealista a bloqué la requête
404 La liste des provinces était absente
500 La page n'a pas pu être lue

API associées

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

Tout voir
Idealista Property/v2/idealista/property

Récupérez bien Idealista par URL : prix, specs, photos par pièce, DPE et données annonceur.

GET3 crédits = 1 requêteActif
Idealista Search/v2/idealista/search

Récupérez biens Idealista par URL de recherche : prix, specs, agence et pagination. WebUnlocker, 3 crédits. Passez une URL de province renvoyée par `/v2/idealista/provinces` (`results[].url`) dans `query`. Madrid : `https://www.idealista.com/venta-viviendas/madrid-provincia/`.

GET3 crédits = 1 requêteActif

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
Commencer gratuitement (+500 crédits)PiloterrParler à un expert