# Idealista Scraper API: Property Listings as JSON | Scrapier (https://scrapier.io/scrapers/idealista/)

> Idealista scraper API: sale and rental listings in Spain, Portugal and Italy as typed JSON, with details and stats. 2 credits per call. Get a free API key.

Last updated: 2026-11-10

**id**

## Idealista Scraper API: _1 endpoint_, structured JSON

Homes for sale and rent on Idealista in Spain, Portugal and Italy: price, size, rooms, type and location for every listing in a search, with optional per-listing details and stats, as typed JSON. Public data only.

[Get a free API key →](https://app.scrapier.io/sign-up)

Copy for your AI agent

**1**Idealista endpoint

**1**credit per successful call

**0**credits for a failed call

**1**need no Idealista login

Quick answerScrapier returns typed JSON from **1 Idealista endpoint**: sale and rental property listings with price, size, rooms, type and location. Public data only and no proxies; no Idealista login needed. 1 credit per successful call; failed calls are free. Last verified 9 Nov 2026

Endpoints

## What data can I extract with Idealista Scraper?

One endpoint covers Idealista: send a place name, a location ID or property codes and get clean JSON back, for 2 credits per successful call.

### Property listingsStart here

`**GET**/api/v2/idealista/`

Sale or rental listings for a place name or location ID, 50 per page: price, size, rooms, type, municipality and URL.

1 credit per call_View →Page soon_

Playground

## Try Idealista Scraper Live

Pick an endpoint, fill in the input and press **Run**. Without a key you see the catalog sample and nothing is billed. With your API key it runs a real call from your browser.

Idealista**Property listings**Live

Platform

Endpoint

Parameters

### \+ Run live with your API key

Response

Sample dataCatalog sample, run to see live data

Pricing

## How much will scraping Idealista cost?

Every successful call costs 1 credit, whether the page holds one profile or a page of comments. Failed calls cost nothing. A free tier lets you try it first.

On Pro, 1,000 calls at 1 credit cost $1.58. Scale brings that to $1.20, so 250,000 Idealista calls a month is $299.

[See all plans →](https://scrapier.io/pricing/)

| Plan | Price / mo | Credits / mo | Per 1,000 calls |
| --- | --- | --- | --- |
| Free | $0 | Free tier | — |
| Hobby | $29 | 15,000 | $1.93 |
| Pro | $79 | 50,000 | $1.58 |
| Scale | $299 | 250,000 | $1.20 |

How to

## How do I use Idealista Scraper?

Built to be easy to start with, even if you've never scraped a website. Here's how to get Idealista data in a few minutes:

[Get a free API key →](https://app.scrapier.io/sign-up)

1. **Create a free Scrapier account**[Sign up](https://app.scrapier.io/sign-up) with your email and copy your API key.
2. **Choose the country**Set `country` to `es`, `pt` or `it`.
3. **Add your location**One place name such as Madrid, or an Idealista location ID, in `location` per call.
4. **Pick sale or rent**Set `operation` to `sale` or `rent`, and the order with `sort_by`.
5. **Page through the results**Each page holds up to 50 listings and `next_cursor`; pass it back as `cursor` for the next page.
6. **Run the request**One GET with your key in the `X-API-Key` header, or ask your AI agent over MCP.
7. **Save the results**JSON from the API: store it as is, or flatten it to CSV in a few lines.

Input

## Input

Every endpoint takes the same kind of input.

1

### By location

Start from a place, an area or a ZIP code.

Property listings`Madrid`

Best forlocal data · city, area or ZIP code

Example requests

// GET /api/v2/idealista/
{
  "location": "Madrid",
  "operation": "sale",
  "property\_type": "homes",
  "country": "es",
  "sort\_by": "mostRecent",
  "fetch\_details": "true",
  "fetch\_stats": "true"
}

| Send this | Parameter | And you can get |
| --- | --- | --- |
| Place name or location ID | `location` · `country` | Listings in that area with price, size, rooms, type and URL |
| Sale or rent | `operation` · `property_type` · `sort_by` | Only the listings and order you need |
| Property codes | `property_codes` | Those listings looked up directly |
| Extra data per listing | `fetch_details` · `fetch_stats` | Per-listing details and stats added to each row |

Optional on list endpoints: `cursor` (pass back `next_cursor` for the next page). Auth is one header: `X-API-Key`. Send parameters in the query string (GET) or as a JSON body (POST).

Output

## Output

The one thing to know: **each data type has its own shape**. Field names stay the same on every call, so code and agents read them directly. Samples below come from the live catalog.

// GET /api/v2/idealista/?location=Madrid
// one item of data.listings · catalog sample
{
  "propertyCode": "111843951",
  "price": 499900,
  "operation": "sale",
  "propertyType": "flat",
  "size": 75,
  "rooms": 2,
  "municipality": "Madrid",
  "thumbnail": "https://img4.idealista.com/.../111843951.jpg",
  "url": "https://www.idealista.com/inmueble/111843951/",
  "scraped\_at": "2026-06-24T12:00:00.000Z"
}

Every response is `{"success": true, "data": {…}}`: your input echoed back, the result under its own key (`profile`, `posts`, `comments`…) and `next_cursor` for the next page.

Use cases

## What can you do with Idealista data?

Public Idealista data powers real estate market research in Spain, Portugal and Italy, rental yield estimates and new listing alerts. Here are three common jobs, and how the Idealista scraper endpoint runs each one.

01

### Price per square meter by area

Pull every sale listing in a municipality with price and size, then compute the median price per square meter by district and property type.

1. _1_idealista
2. Market table

MonthlySheets, BI tool

02

### Rental yield estimates

Search the same location twice, once with operation sale and once with rent, and compare typical asking rent with asking price for similar flats.

1. _1_idealista
2. Yield map

MonthlySheets, database

03

### New listing alerts

Sort by most recent and run the search every day. New property codes since the last run are fresh listings to call about before anyone else.

1. _1_idealista
2. Alert feed

DailyEmail, CRM

Features

## Features

Idealista Scraper fetches clean, structured Idealista data at low cost: built for market research, rental analysis, listing alerts and AI agents.

### Live data, every call

Each request reads Idealista at call time, and every listing says when in `scraped_at`.

### Typed, consistent JSON

Same field names on every call: price, size and rooms as numbers.

### Lists, page by page

Up to 50 listings per page with `next_cursor`; run up to 3 requests in parallel per key.

### Three countries

Spain, Portugal and Italy through one `country` parameter.

### MCP-ready for AI agents

The Scrapier MCP server reaches the endpoint from Claude Code, Cursor, Windsurf and VS Code with one command.

### Works with your stack

Plain REST: Python, Node.js, cURL, n8n, Make, Zapier or Google Sheets.

### Details and stats on request

`fetch_details` and `fetch_stats` add per-listing details and stats to each row.

### Maintained for you

When Idealista changes its pages, Scrapier updates the scraper; your field names stay the same.

### Pay per successful call

2 credits per call, however many listings the page holds. Failed calls are never billed.

Why Scrapier

## Why choose this Idealista Scraper?

Idealista's own API is available by request: you apply, and approved users get a key and secret with a usage quota Idealista sets. Scrapier reads public Idealista listings with one API key, at a price you know before the call runs.

[Get a free API key →](https://app.scrapier.io/sign-up)[See pricing](https://scrapier.io/pricing/)

**0**Credits for a failed call

Any non-2xx response is free, so retries cost nothing.

**$1.20**Per 1,000 calls on Scale

At 2 credits a call, with up to 50 listings per call.

**0**Applications to file

No API access request, key and secret or OAuth token to manage.

**1 key**For 35 platforms

The same key and JSON envelope cover Zillow, Realtor.com, Airbnb, Google Maps and more.

| Feature | Scrapier Idealista Scraper | Idealista API (by request) | DIY scraper |
| --- | --- | --- | --- |
| Whose data | Any public listing | Public listings, after approval | Any public listing |
| Setup | One API key | Access request, key and secret | Proxies, browsers, parsers |
| Maintenance | Handled by Scrapier | Token handling, API changes | Breaks on layout changes |
| Cost | From $1.20 per 1,000 calls | Quota set by Idealista | Servers, proxies and engineering time |
| AI agents | MCP server included | Build your own | Build your own |

FAQ

## Frequently asked questions

### Which countries does the Idealista scraper cover?

Spain, Portugal and Italy, the three Idealista markets the endpoint supports. Set country to es, pt or it. The location you send must be in that country, and the setting is locked into the cursor for every page.

### What can I send as the location?

A place name such as Madrid, or an Idealista location ID such as 0-EU-ES-28-07-001-079 for a precise area. Send one location per call. To look up known listings instead, send their codes in property\_codes.

### Can I scrape rentals as well as homes for sale?

Yes. Set operation to sale or rent. Use property\_type to choose the kind of property and sort\_by to set the order; the default is most recent first. These settings are locked into the cursor.

### What data comes back for each listing?

Each row has the property code, price, operation, property type, size, rooms, municipality, thumbnail, listing URL and scraped\_at time. With fetch\_details and fetch\_stats on, each row also carries per-listing details and stats.

### How many results can I get?

As many as Idealista shows publicly for the search. Each page holds up to 50 listings and next\_cursor; pass it back as cursor for the next page. The response also gives the total count. Each page is one call at 2 credits.

### Why is a field sometimes null?

When Idealista doesn't show a value, the field is null, so you can tell "not shown" from zero. Check for null before you compute averages such as price per square meter.

### Is it legal to scrape Idealista?

It depends on what you collect, where you are and how you use it, so this is not legal advice. Scrapier returns publicly visible data only. Advertiser contact details in listing details can be personal data under GDPR, so collect only what you have a legitimate reason to use.

### Can I connect Idealista data to other tools?

Yes. Any tool that can make an HTTP request works: n8n, Make, Zapier, Google Sheets, Airbyte or your own code. Send your key in the X-API-Key header and read the JSON response.

### Can I get Idealista data through an MCP server?

Yes. Run claude mcp add -t http scrapier https://mcp.scrapier.io/mcp with your key in an X-API-Key header. The agent finds the Idealista endpoint with search\_endpoints and calls it with run\_scrape, in Claude Code, Cursor or Windsurf.

### Idealista Scraper not working?

Check the status code first: 401 means the X-API-Key header is missing, 403 an invalid key, 402 no credits left, 429 too many requests (wait Retry-After seconds). Check that the location exists in the country you set, then report the request and response.

### How much does the Idealista scraper cost?

The Idealista endpoint costs 2 credits per successful call, however many listings the page holds. Failed calls are free. Plans: Hobby $29 for 15,000 credits, Pro $79 for 50,000, Scale $299 for 250,000, Enterprise custom. A free tier lets you try it first.

### What are the Idealista scraper rate limits?

Run up to 3 requests in parallel per API key. If you go faster, the API answers 429 with a Retry-After header: wait that many seconds and retry. 429 and 5xx responses are never billed. Set a client timeout of 210 seconds or more.

### How do I scrape Idealista with Python?

Use the requests library: requests.get("https://proxy.scrapier.io/api/v2/idealista/", headers={"X-API-Key": key}, params={"location": "Madrid", "operation": "sale", "country": "es"}, timeout=210). Read r.json()\["data"\]\["listings"\] directly; there is no HTML to parse or proxy to run.

### Does Idealista have an official API?

Yes, by request. Idealista reviews applications and gives approved users a key and secret with a usage quota it sets. Scrapier needs no application: one API key reads public Idealista listings in Spain, Portugal and Italy.

Other platforms

## You might also like

[### Zillow

2 endpoints](https://scrapier.io/scrapers/zillow/)[### Realtor.com

3 endpoints](https://scrapier.io/scrapers/realtor/)[### Airbnb

5 endpoints](https://scrapier.io/scrapers/airbnb/)[### Google

12 endpoints](https://scrapier.io/scrapers/google/)[### LinkedIn

8 endpoints](https://scrapier.io/scrapers/linkedin/)

Get started

## Start pulling Idealista data in 60 seconds

Free API key. No sales call, no proxy setup, and failed calls are free.

[Get your API key →](https://app.scrapier.io/sign-up)[Browse all 1 endpoints](#endpoints)

---
Canonical page: https://scrapier.io/scrapers/idealista/
Site index for AI agents: https://scrapier.io/llms.txt
