Examples
Update Settings
Configure the Idealista Listings Scraper parameters and options
The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POST
https://api.lobstr.io/v1/squids/{squid_hash}Configure your Idealista Listings Scraper squid settings to control pagination and scraping behavior. Adjust the maximum pages to scrape based on your needs.
Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredRequest body format. Value: application/json
Squid Parameters
The following parameters can be configured in the params object:
| Parameter | Type | Default | Description |
|---|---|---|---|
| max_pages | integer | 60 | Maximum number of search result pages to scrape (max: 100) |
| get_property_details | boolean | false | Visit each listing page to collect full property characteristics (year built, orientation, energy certificate, community costs, etc.). Increases credit usage. |
General Settings
Standard squid settings that apply to all scrapers:
| Setting | Type | Description |
|---|---|---|
| name | string | Display name for your squid configuration |
| concurrency | integer | Number of parallel scraping threads (default: 1) |
| export_unique_results | boolean | Export only unique results (deduplicated) |
| to_complete | boolean | Run until all tasks complete |
| no_line_breaks | boolean | Remove line breaks from results |
Idealista typically shows 30 listings per page. Setting max_pages to 60 can yield up to 1,800 listings per search URL.
Keep concurrency at 1 for Idealista to avoid rate limiting issues.
Code Examples
curl -X POST "https://api.lobstr.io/v1/squids/YOUR_SQUID_HASH" \ -H "Authorization: Token YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Idealista Iter Listings (1)", "concurrency": 1, "export_unique_results": true, "to_complete": false, "no_line_breaks": true, "params": { "max_pages": 60, "get_property_details": false } }'
Response
201
{ "name": "Idealista Iter Listings (1)", "concurrency": 1, "export_unique_results": true, "to_complete": false, "no_line_breaks": true, "params": { "max_pages": 60, "get_property_details": false } }