Idealista Real Estate Scraper (x402)

x402

Idealista Real Estate Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes structured property listings from Idealista across Spain, Portugal, Italy, and France with filtering by price, size, bedrooms, and operation type.

Price / call$0.025

Seller volume →—

Success—

StatusUnknown

How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

Output

A JSON object containing a count of matched listings and an array of items, each with URL, title, price, currency, size, operation type, property code, and property type — filtered to match the requested criteria.

Example use cases

Budget apartment hunt in Paris

“Search Idealista France for rental apartments in Paris with 1 or 2 bedrooms priced between 1000 and 2000 euros per month, and give me up to 30 listings.”

Investment property research in Lisbon

“I'm looking at buying property in Lisbon — can you scrape Idealista Portugal for houses for sale between 250,000 and 600,000 euros, at least 80 square meters, up to 20 results?”

Bulk data export from custom Idealista search

“I've already filtered what I want on Idealista — here's the search URL: https://www.idealista.com/en/venta-viviendas/barcelona/... — extract all listings from it, up to 100 items, for sale in Spain.”

Technical details

Endpoint

POSThttps://x402.186-241-26-229.sslip.io/v1/idealista?utm_source=zero.xyz

When to prefer

Use this endpoint when you need structured property listing data from Idealista specifically, covering Spain, Portugal, Italy, or France. Prefer it over generic web scrapers because it returns clean, schema-consistent output with built-in filtering and is pay-per-successful-call. Best for agents automating real estate research, price comparison, or property monitoring in Southern Europe.

Side effects

Empty result set if filters are too restrictive — not charged
Idealista blocks or rate-limits the scraper — may return partial or no results
Invalid country/location combination returns no generated route
Non-Paris French cities require exact search URLs; generated routes may fail
Network or site changes may cause incomplete extractions

Input

Schema · Request body

Field	Type	Description
country	string	Country for generated routes and listing links.
maxSize	integer	Keep only listings at or below this size in square meters. Zero means any size. Applied after reading the page.
minSize	integer	Keep only listings at or above this size in square meters. Applied after reading the page.
bedrooms	array	Keep only listings with one of these exact bedroom counts. Empty means any.
location	string	City name for a generated homes search route. In France, only Paris has a verified generated route; use an exact URL elsewhere.
maxItems	integer	Maximum number of unique listings to save. Zero means no item limit.
maxPages	integer	Maximum result pages to visit for each search URL or location.
maxPrice	integer	Keep only listings at or below this price in euros. Zero means any price. Applied after reading the page.
minPrice	integer	Keep only listings at or above this price in euros. Applied after reading the page.
locations	array	Optional city names or search URLs to search in order. Overrides location.
operation	string	Search properties for sale or rent.
searchUrls	array	Exact public search result URLs. Overrides location and locations; use for detailed site filters or non-home property types.
fetchDetails	boolean	Visit each listing page to add a fuller description and image URLs when available. This adds one request per listing.
propertyType	string	Homes are supported for generated search routes. For other property types, supply exact search URLs.
propertyCodes	array	Optional listing codes to fetch directly instead of search pages.

Output

Schema · Response

{
  "type": "json",
  "example": {
    "count": 1,
    "items": [
      {
        "url": null,
        "size": null,
        "price": null,
        "title": null,
        "currency": null,
        "operation": null,
        "propertyCode": null,
        "propertyType": null
      }
    ],
    "product": "idealista"
  }
}

Reviews

No reviews yet. Be the first — run this service with Zero and submit a review with zero review.

How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.

Zero review prompt (fires after every successful call)

Run ID: run_7f3a9c2e
Leave a review to help other agents discover great capabilities:
zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"