The Idealista listings API reads a search result page and returns one row per property — title, listing URL, price with its parsed numeric value, price per square metre, room count, size, the detail chips shown on the card, a description excerpt, the listing agency and a thumbnail.
It covers the three Idealista markets — es for Spain, it for Italy and pt for Portugal — and takes either a location slug like madrid-madrid or a full listing URL you paste in. Each page is fetched over the TLS tier through a European residential exit; a search that returns nothing chargeable comes back empty rather than as invented rows.
$0.001 per delivered listing, up to 100 listings per run. Nothing delivered means nothing charged.
You choose the site (es, it or pt), set operation to sale or rent, and pass a location — a slug such as barcelona-barcelona, or a full Idealista search URL when you want to reproduce an exact filtered view. The collector reproduces that search and pages through the results.
Every card is parsed into a flat row. Two things are worth knowing:
price keeps the string as displayed and price_value is the parsed number, so you can sort and average without stripping euro signs and thousands separators yourself.agency holds the listing agency, or is null when the seller is a private individual — a distinction that matters for lead work and for filtering out professional inventory.Comparing European stock against the US market? The Zillow search collector is the equivalent for American listings and returns a comparable row shape.
The required input is location — a slug or a full listing URL. site selects the country portal and its matching exit; operation switches between sale and rent. max_results caps the run at up to 100 listings, defaulting to 30, which keeps a quick probe cheap while letting a full sweep go wide.
Each listing is one flat row. price_value is the number behind price, and price_per_m2 preserves the per-square-metre figure Idealista shows. rooms and size_m2 are typed for direct filtering, while details keeps the card's chips — floor, lift, terrace and the like — as a string array you can scan for features the structured fields do not capture.
$0.001 per delivered listing (
$0.001 per delivered listing,
The free monthly allowance is $2 of usage, roughly 2,000 listings a month at this price, with no card required. GET /v1/scraper/collectors reports the exact rate your key pays.
Idealista does publish an official API, and where it fits it is the right tool. The friction is access: you apply for OAuth2 credentials, approval is discretionary and skewed toward research and partner use, and the free allowance is measured in a small number of requests per month before you negotiate a paid arrangement. For anyone doing continuous market monitoring, that envelope is tight.
This collector reads the same public search pages a house-hunter browses, so there is no application queue and no monthly request ceiling handed down by the portal — the limit is your QuantumProxies plan. You forgo the official API's account-linked fields in exchange for open-ended volume across the sale and rent listings that are visible to everyone.
A single Idealista page is easy to pull once. Doing it continuously across three countries is the real job:
Handing that off gives you a stable, typed schema and per-row billing. If you would rather run your own crawler and only need clean EU exits beneath it, the residential proxies are the network this collector already uses.
Pull sale and rent runs for the same location and divide price_value figures to estimate gross yield, using price_per_m2 to normalise across property sizes.
Re-run a saved location and diff listing_id values to surface fresh listings within minutes of them appearing, before the popular ones are gone.
Segment a city's inventory by whether agency is set to measure how much stock is professional versus private — useful for both competitive and lead-generation work.
One run returns up to 100 listings for a location; deeper coverage means running more locations or more filtered URLs rather than one endless page. Runs are independent and parallelise up to your plan's rate limit — 60 requests a minute on pay-as-you-go, up to 1,200 on the top tier. This collector reads the search result card; it does not open each listing's own detail page for the full photo set or the seller's phone number.
Legally: these listings are shown publicly to every visitor, and collecting public data is generally lawful in much of the EU, but Idealista's terms restrict automated access, GDPR governs any personal data you touch, and downstream use carries its own duties. This is not legal advice — get proper advice for your use.
Idealista's official API has a small free request allowance but requires an approved OAuth2 application, and approval leans toward research and partners. This collector needs no application and includes a $2 monthly allowance, about 2,000 listings at $0.001 each, before any charge.
No. There is no Idealista developer registration or OAuth credential to obtain. You authenticate with your QuantumProxies key, and the collector reads the public search pages for Spain, Italy or Portugal directly.
The three Idealista portals: Spain (es), Italy (it) and Portugal (pt). You pick one with the site parameter, and the request exits from a residential IP in that market so the listings and pricing match what a local sees.
Yes. The location field accepts either a location slug like madrid-madrid or a full Idealista listing URL, so you can copy a search you have already filtered on the site and reproduce exactly that result set.