Idealista Property Search & Analytics

Complete real estate intelligence platform combining location resolution with comprehensive property search, market analytics, and premium features. Supports Spain (ES), Italy (IT), and Portugal (PT). Perfect for real estate investors, market researchers, and lead generation businesses.

Run on Apify

Actor URL: apify.com/axlymxp/idealista-property-search-analytics

Apify Console

1. Open the actor page and click Start
2. Enter input (see schema below)
3. Click Run and monitor execution
4. Download results from the Dataset tab

API

curl -X POST "https://api.apify.com/v2/acts/axlymxp~idealista-property-search-analytics/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"q": "Madrid", "country": "es"}'

JavaScript SDK

const { ApifyClient } = require('apify-client');
const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('axlymxp/idealista-property-search-analytics').call({
  q: 'Madrid',
  country: 'es'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Input

Basic Parameters

Field	Type	Required	Description
q	string	Required	Location query string to resolve
country	string	No	Country code (es, it, pt). Default: es
custom_extractor	string	No	Optional custom processing function

Output

Returns an array of location objects found for the query. Each location includes:

• name: Location name
• locationId: Idealista location ID
• type: Location type
• totalProperties: Number of properties in this location
• divisible: Whether location can be subdivided
• subTypeText: Additional location information
• query: The original query string used
• query_timestamp: When the query was processed

If a custom_extractor is provided, locations may be transformed according to the custom logic.

If the custom extractor encounters errors, locations will include:

• custom_extractor_error: Error details for debugging
• raw: Original API response data (only when errors occur)

Rate Limiting

• 1 second minimum between requests
• Exponential backoff on errors (1s, 2s, 4s)
• Max 3 retries per city

Pricing

This actor is free to use. Each run resolves a location query and returns matching location data.

Run Locally

cd idealista/location-resolver
npm install
apify run

Example

{
  "q": "Madrid",
  "country": "es"
}

With custom extractor:

{
  "q": "Barcelona",
  "country": "es",
  "custom_extractor": "function(query, location) { return { ...location, search_query: query, normalized_name: location.name.toLowerCase() }; }"
}