Skip to content
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.
POSThttps://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

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request 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
  }
}