Immobilier

Idealista Scraper

idealista.com

Idealista est servi via deux endpoints de plugin dédiés plutôt que par la récupération de page générique, sur ses trois sites : idealista.com (Espagne), idealista.it (Italie) et idealista.pt (Portugal). L'endpoint de recherche prend un lieu tel qu'idealista l'écrit dans ses URL - une commune comme madrid-madrid ou milano-milano, un quartier comme madrid/centro ou lisboa/arroios, ou une province comme malaga-provincia - ou n'importe quelle URL de recherche idealista avec ses filtres, et renvoie les annonces déjà parsées : identifiant, lien, titre, prix avec devise et période de location, le prix d'origine et la baisse en pourcentage après une réduction de prix, prix au m², surface, pièces, étage, indicateurs d'ascenseur, d'exposition extérieure et de parking, description, étiquettes, photos, indicateurs de plan, de vidéo et de visite 3D, et l'agence. Filtrez par vente ou location, type de bien (logements, logements neufs, bureaux, locaux commerciaux, garages, terrains, débarras, immeubles ou chambres à louer), fourchettes de prix et de surface, pièces, salles de bains et caractéristiques comme l'ascenseur, la terrasse, la piscine ou le jardin, et triez par prix, date, surface, prix au m² ou plus forte baisse de prix. Les résultats arrivent par pages de 30, et un appel en réunit jusqu'à 300 sur plusieurs pages, dans la limite des 60 pages qu'idealista affiche par recherche. L'endpoint de détail prend un identifiant ou une URL d'annonce et renvoie l'annonce complète : titre, localisation, opération, type de bien, prix, le détail du prix qu'affiche idealista (comme les charges de copropriété ou une caution), surface et surface utile, pièces, salles de bains, étage, ascenseur, année de construction, classe et consommation énergétiques, chaque groupe de caractéristiques listé par idealista, description, lignes d'adresse, coordonnées, la galerie photo, les plans, l'annonceur et la dernière mise à jour. Aucun compte idealista ni clé d'API n'est nécessaire.

Ce que vous pouvez extraire

• Identifiant de l'annonce, lien, titre, prix, devise et période de location
• Prix d'origine et baisse de prix en pourcentage après une réduction, et prix au m²
• Surface, pièces, étage, indicateurs d'ascenseur, d'exposition extérieure et de parking
• Description, étiquettes, photos et indicateurs de plan, de vidéo et de visite 3D
• Agence, et si l'annonceur est un professionnel
• Filtres : vente ou location, neuf types de bien, fourchettes de prix et de surface, pièces, salles de bains et 14 caractéristiques ; 10 ordres de tri
• Détail : détail du prix, surface utile, salles de bains, année de construction, classe et consommation énergétiques, et chaque groupe de caractéristiques
• Détail : lignes d'adresse, coordonnées, galerie photo, plans, annonceur et dernière mise à jour
• Espagne, Italie et Portugal ; 30 annonces par page, jusqu'à 300 par appel et 60 pages par recherche

Endpoints dédiés

Comment le scraper

curl -X POST \
  -H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
  "https://api.scrapeunblocker.com/realestate/idealista?location=madrid-madrid&country=es&operation=rent"

import requests

resp = requests.post(
    "https://api.scrapeunblocker.com/realestate/idealista",
    headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
    params={"location": "madrid-madrid", "country": "es", "operation": "rent"},
)
print(resp.text)

import { ScrapeUnblockerClient } from 'scrapeunblocker';

const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });

const results = await su.idealistaSearch('madrid-madrid', {
  country: 'es',
  operation: 'rent',
});
const listing = await su.idealistaDetail('https://www.idealista.it/immobile/37068709/');
console.log(results);
console.log(listing);

Les requêtes sont en POST et passent leurs paramètres dans la query string. Le rendu navigateur a toujours lieu : aucun flag à activer.

Exemple de réponse

{
  "listings": [
    {
      "id": "88108287",
      "url": "https://www.idealista.com/inmueble/88108287/",
      "title": "Dúplex en Calle de Fortuny, Almagro, Madrid",
      "priceText": "6.750 €/mes",
      "price": 6750,
      "currency": "EUR",
      "pricePeriod": "month",
      "parking": "included",
      "rooms": 4,
      "area": 176,
      "floor": "6ª planta exterior con ascensor",
      "lift": true,
      "exterior": true,
      "description": "ÁTICO - DUPLEX, en el mejor tramo de la calle Fortuny, en edificio representativo, con PLAZA de GARAJE en el mismo edificio, esta propiedad está distribuida de la siguiente manera:...",
      "tags": [
        "Lujo"
      ],
      "images": [
        "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/4d/4c/40/738803992.jpg"
      ],
      "imageCount": 41,
      "multimedia": [
        "VIDEO"
      ],
      "agency": {
        "name": "Jaime Valcarce Consulting Inmobiliario",
        "url": "https://www.idealista.com/pro/jaime-valcarce-consulting-inmobiliario/",
        "logo": "https://st3.idealista.com/df/c3/43/jaime-valcarce-consulting-inmobiliario.gif"
      },
      "professional": true
    },
    {
      "id": "109738824",
      "url": "https://www.idealista.com/inmueble/109738824/",
      "title": "Piso en Calle de Villamanín, Lucero, Madrid",
      "priceText": "1.800 €/mes",
      "price": 1800,
      "currency": "EUR",
      "pricePeriod": "month",
      "rooms": 3,
      "area": 115,
      "floor": "6ª planta exterior con ascensor",
      "lift": true,
      "exterior": true,
      "published": "1 hora",
      "description": "DISPONIBLE DESDE 1 DE DICIEMBRE. CONTRATO HABITUAL, LARGA ESTANCIA! SE PUEDE VISITAR Y RESERVAR DESDE AHORA. METRO BATAN A 1 MIN. ANDANDO. ¡Descubre tu nuevo hogar en el corazón de...",
      "images": [
        "https://img4.idealista.com/blur/480_360_mq/0/id.pro.es.image.master/fb/a8/89/1384095761.jpg"
      ],
      "imageCount": 33,
      "professional": true
    }
  ],
  "resultsCollected": 30,
  "totalResults": 9133,
  "heading": "9.133 casas y pisos en alquiler en Madrid",
  "page": 1,
  "pagesFetched": 1,
  "hasMore": true,
  "nextPage": 2,
  "viewLimitReached": false,
  "country": "es",
  "searchUrl": "https://www.idealista.com/alquiler-viviendas/madrid-madrid/",
  "query": {
    "country": "es",
    "operation": "rent",
    "propertyType": "homes",
    "location": "madrid-madrid",
    "sort": "relevance"
  }
}

Lire la documentation de l'API

Questions fréquentes

Scrapers similaires