---
title: "Scrape one idealista listing (Spain, Italy, Portugal)"
method: POST
path: "/realestate/idealista-detail"
tags: ["Plugins"]
---

# Scrape one idealista listing (Spain, Italy, Portugal)

`POST /realestate/idealista-detail`

## Request

- Base URL: `https://api.scrapeunblocker.com`
- URL: `https://api.scrapeunblocker.com/realestate/idealista-detail`
- Auth: API key in header `x-scrapeunblocker-key`

Given an idealista `listing` id (with `country`) or URL, returns the listing as JSON: `title`, `locationLine`, `operation`, `propertyType`, `price` + `currency` (+ `pricePeriod`), `originalPrice`/`priceDropPercent`, `pricePerM2`, `priceDetails` (the price breakdown idealista shows, e.g. community fees or deposit), `area`, `usableArea`, `rooms`, `bathrooms`, `floor`, `lift`, `builtYear`, `energyRating`, `features` (every feature group idealista lists), `description`, `address`, `coordinates` (`locationApproximate` when the advertiser hid the exact spot), `images`, `floorPlans`, `multimediaCounts`, `advertiser` (name, type, reference, agency page) and `updated`. A listing its advertiser removed answers 404. Billed one unit.

## Query parameters

- `listing` string, nullable: idealista listing id ('111278716') or URL, e.g. https://www.idealista.com/inmueble/111278716/, https://www.idealista.it/immobile/37068709/ or https://www.idealista.pt/imovel/34868387/.
- `country` string: Country of a bare listing id: es, it, pt. Ignored for a URL.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2). Leave blank for the exit chosen for the site.

## Response `200`

JSON with a `listing` object.

- unknown

## Other responses

- `400`: Invalid parameters.
- `404`: idealista says the listing does not exist or was removed.
- `422`: Validation Error
- `502`: Blocked by idealista on every attempt, no listing page returned, or idealista did not answer in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)