Idealista: scrapers and the official API, compared

Route map

Each line is one way to get Idealista data; each stop is a field you probably need. Green lines are catalogue Actors, ranked by the published formula.

Field matrix: who returns what

Every tool with a published output schema, against the 7 fields most Idealista jobs need. A dot means the field name appears in the schema; rows can still leave it empty.

Field dictionary: the exact keys

The same core field has a different key in each Actor's output. Map these before you merge datasets; a dash means the published schema has no matching key. Need a field that is not listed here, such as email? Search every Idealista Actor by field.

Download this comparison: CSV · JSON (every tool with a published schema, matching keys per core field, price and score).

All 9 tools, scored

Catalogue Actors link to their detail pages; the score (0 to 100) is the published formula, identical for every tool. Other Store tools follow in their own table, for reference. Price is the published primary-result rate per 1,000 (the Free-plan rate where the price is tiered; higher Apify plans pay less); start events and platform usage are excluded.

Other Store tools, for reference

Scored with the same published formula and listed for comparison only; this site does not link or recommend them.

What to check before you choose

Teams use Idealista data to compare property asking prices, examine features and monitor listing changes across Spain, Portugal and Italy. Keep country coverage and sale or rental scope explicit when building a comparison dataset.

The professional API route suits approved customers working within its access conditions. A public listing scraper fits research on visible listings when its documented geographic coverage and output fields match the task.

Checklist

• Confirm support for the intended country and listing type.
• Check definitions before mapping rooms to bedrooms or size to area. The published field descriptions leave those meanings unspecified.
• Confirm agency coverage separately from phone. The published schema includes phone but does not list agency.

Where the data is incomplete

The published schema includes priceDropPercent and updatedAt, but neither field has a detailed definition.

The tool publishes address and municipality. Agency identification is also absent from the field list, even though agency is a reference requirement.

Official API route

Terms and personal data

Keep scraping to public listings and follow Idealista's terms, including the usage conditions attached to any approved API access. Review permitted reuse before sharing listing or contact data. This is general information, not legal advice.

Read Idealista's terms. Keep to public data, do not bypass logins or access controls, and check whether personal data is involved before you collect it. The can-I-scrape checklist walks through it.

How to start

1. Open the recommended Idealista tool and confirm its documented support for the intended country, location and sale or rental search.
2. Collect a small set of listings using the supported input format, then compare returned records with their source pages.
3. Review price, address, url and the meanings of property measurements, then save the dataset for comparison with later collections.

Call Idealista Search Listings Price & Feature Scraper from code

The example input uses the Actor's published defaults; set your own Idealista query before you run it. You need an Apify API token.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "search",
    "location": "roma-roma",
    "operation": "sale",
    "propertyType": "homes",
    "country": "it",
    "propertySubtype": "any",
    "rooms": "any",
    "bathrooms": "any",
    "condition": "any",
    "hasLift": False,
    "hasTerrace": False,
    "hasPool": False,
    "hasGarden": False,
    "hasGarage": False,
    "hasStorageRoom": False,
    "hasAirConditioning": False,
    "hasBalcony": False,
    "isNewDevelopment": False,
    "isBankOwned": False,
    "isAuction": False,
    "isLuxury": False,
    "hasSeaViews": False,
    "isAccessible": False,
    "sortBy": "relevance",
    "onlyPriceDrops": False,
    "onlyPrivateOwners": False,
    "fetchDetails": False,
    "maxDetails": 3,
    "maxItems": 3,
    "partitionLargeSearches": False
}

run = client.actor("vexaloom-labs/idealista-search-listings-price-and-feature").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "search",
    "location": "roma-roma",
    "operation": "sale",
    "propertyType": "homes",
    "country": "it",
    "propertySubtype": "any",
    "rooms": "any",
    "bathrooms": "any",
    "condition": "any",
    "hasLift": false,
    "hasTerrace": false,
    "hasPool": false,
    "hasGarden": false,
    "hasGarage": false,
    "hasStorageRoom": false,
    "hasAirConditioning": false,
    "hasBalcony": false,
    "isNewDevelopment": false,
    "isBankOwned": false,
    "isAuction": false,
    "isLuxury": false,
    "hasSeaViews": false,
    "isAccessible": false,
    "sortBy": "relevance",
    "onlyPriceDrops": false,
    "onlyPrivateOwners": false,
    "fetchDetails": false,
    "maxDetails": 3,
    "maxItems": 3,
    "partitionLargeSearches": false
};

const run = await client.actor("vexaloom-labs/idealista-search-listings-price-and-feature").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/vexaloom-labs~idealista-search-listings-price-and-feature/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"search","location":"roma-roma","operation":"sale","propertyType":"homes","country":"it","propertySubtype":"any","rooms":"any","bathrooms":"any","condition":"any","hasLift":false,"hasTerrace":false,"hasPool":false,"hasGarden":false,"hasGarage":false,"hasStorageRoom":false,"hasAirConditioning":false,"hasBalcony":false,"isNewDevelopment":false,"isBankOwned":false,"isAuction":false,"isLuxury":false,"hasSeaViews":false,"isAccessible":false,"sortBy":"relevance","onlyPriceDrops":false,"onlyPrivateOwners":false,"fetchDetails":false,"maxDetails":3,"maxItems":3,"partitionLargeSearches":false}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=vexaloom-labs/idealista-search-listings-price-and-feature",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Questions people ask

More on Idealista

• Country comparisonSpain property data: Idealista and Fotocasa compared
• Topic groupReal estate data: every website compared
• ToolWhich Idealista route fits your job?
• ToolIdealista cost by Apify plan, rows and runs

Related websites

• Fotocasa1 Actor
• Immowelt1 Actor
• Willhaben1 Actor

Sources

• Idealista Search Listings Price & Feature Scraper on Apify Store
• Idealista API for professionals documentation
• Idealista terms