# Update Settings

Configure the Leboncoin Listings Search Export scraper settings

Configure your Leboncoin Listings Search Export squid settings. Control pagination, result limits, time filters, and whether to include seller shop URLs.

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

## Scraper Parameters

Set these parameters in the `params` object:

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| **max_pages** | integer | 99 | Maximum number of search result pages to crawl (max: 99) |
| **max_results** | integer | unlimited | Maximum number of listings to collect per task |
| **max_unique_results_per_run** | integer | unlimited | Maximum unique results across all tasks in the run |
| **online_shop** | boolean | false | Extract the seller's shop URL (incurs extra requests per listing) |
| **fetch_since** | string | null | Stop scraping when items older than this threshold are reached (based on `last_publication_date`). Use a relative duration (24h, 7d, 2w) or an absolute date (YYYY-MM-DD HH:MM:SS) |
| **fetch_since_timezone** | string | null | Timezone for interpreting an absolute `fetch_since` date (e.g. `Europe/Paris`). Only applies when `fetch_since` is an absolute date — ignored for relative values like `24h` or `7d`. See [supported timezones](https://staging.docs.lobstr.io/docs/timezones). |

## Squid Settings

Configure general squid settings:

| 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>
  Use `fetch_since: 1h` to monitor new listings in near real-time.
</Tip>

<Note>
  Combine with `export_unique_results: true` to avoid duplicates when a listing appears across multiple pages.
</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": "Leboncoin Listings Search Export (1)",
    "concurrency": 1,
    "export_unique_results": true,
    "to_complete": false,
    "no_line_breaks": true,
    "params": {
      "max_pages": 99,
      "fetch_since": "24h",
      "online_shop": 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"

response = requests.post(f"{BASE_URL}/squids/{squid_id}",
    headers=headers,
    json={
        "name": "Leboncoin Listings Search Export (1)",
        "concurrency": 1,
        "export_unique_results": True,
        "to_complete": False,
        "no_line_breaks": True,
        "params": {
            "max_pages": 99,
            "fetch_since": "24h",
            "online_shop": False
        }
    }
)

data = response.json()
print(f"Settings updated: {data['name']}")
```
</CodeGroup>

## Response

```json 201
{
  "name": "Leboncoin Listings Search Export (1)",
  "concurrency": 1,
  "export_unique_results": true,
  "to_complete": false,
  "no_line_breaks": true,
  "params": {
    "max_pages": 99,
    "fetch_since": "24h",
    "online_shop": false
  }
}
```
