# Update Settings

Configure the Idealista Listings Scraper parameters and options

Configure your Idealista Listings Scraper squid settings to control pagination and scraping behavior. Adjust the maximum pages to scrape based on your needs.

## Headers

<ParamField header="Authorization" type="string" required>
  Your API authentication token. Value: `Token YOUR_API_KEY`
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Request body format. Value: `application/json`
</ParamField>

## 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 |

<Tip>
  Idealista typically shows 30 listings per page. Setting max_pages to 60 can yield up to 1,800 listings per search URL.
</Tip>

<Note>
  Keep concurrency at 1 for Idealista to avoid rate limiting issues.
</Note>

## Code Examples

<CodeGroup>
```bash cURL
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
    }
  }'
```

```python Python
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.lobstr.io/v1"
headers = {"Authorization": f"Token {API_KEY}"}

squid_id = "YOUR_SQUID_HASH"

# Configure scraper settings
response = requests.post(f"{BASE_URL}/squids/{squid_id}",
    headers=headers,
    json={
        "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
        }
    }
)

data = response.json()
print(f"Squid updated: {data['name']}")
print(f"Max pages: {data['params']['max_pages']}")
```
</CodeGroup>

## Response

```json 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
  }
}
```
