# Update Settings

Configure settings for your Facebook Marketplace Scraper squid

Update the configuration of your **Facebook Marketplace Scraper** squid. Pass crawler-specific settings inside the `params` object.

## Headers

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

<ParamField header="Content-Type" type="string" required>
  Must be application/json. Value: `application/json`
</ParamField>

## Body

<ParamField body="params" type="object">
  Crawler-specific settings. See fields below.
</ParamField>

## Settings Fields

<ParamField body="params.max_results" type="integer">
  Maximum number of listings to collect per task. Leave empty for unlimited.
</ParamField>

<ParamField body="params.max_unique_results_per_run" type="integer">
  Maximum number of unique listings retrieved across all tasks in the entire run. Leave empty for unlimited.
</ParamField>

<ParamField body="params.fetch_since" type="string">
  Only collect listings published after this point (based on `creation_time`). Use a relative duration (e.g. `"24h"`, `"7d"`, `"2w"`) or an absolute date (`YYYY-MM-DD` or `YYYY-MM-DD HH:MM`). On search URLs, Facebook's matching Date listed filter (last 24 hours, 7 days or 30 days) is added for you. Older listings are skipped and not billed.
</ParamField>

<ParamField body="params.fetch_since_timezone" type="string">
  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"`.
</ParamField>

<ParamField body="params.exclude_outside_search" type="boolean">
  Skip the listings Facebook shows under "Results from outside your search" (outside your search area, or only loosely related to your query) and stop paging once that section starts. Skipped listings are not billed. Default: `false`.
</ParamField>

<ParamField body="params.listing_details" type="boolean">
  Visit each listing's detail page to collect additional fields: full description, condition, precise location (latitude/longitude), seller profile, discount price, and structured listing attributes. Requires one additional request per listing.
</ParamField>

<Tip>
  To collect only new listings on a schedule, set `fetch_since` to the schedule interval (`"24h"` for a daily run, `"7d"` for a weekly one). It also applies to the listings under "Results from outside your search", so each run collects, and bills, only the listings published since the previous run. Set `exclude_outside_search` to `true` only if you don't want those listings at all.
</Tip>

## 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": "Facebook Marketplace Paris",
    "params": {
      "max_results": 200,
      "fetch_since": "24h",
      "exclude_outside_search": true,
      "listing_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_hash = "YOUR_SQUID_HASH"

response = requests.post(f"{BASE_URL}/squids/{squid_hash}",
    headers=headers,
    json={
        "name": "Facebook Marketplace Paris",
        "params": {
            "max_results": 200,
            "fetch_since": "24h",
            "exclude_outside_search": True,
            "listing_details": False
        }
    }
)

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

## Response

```json 201
{
  "id": "YOUR_SQUID_HASH",
  "name": "Facebook Marketplace Paris",
  "crawler": {
    "id": "facebook-marketplace-scraper",
    "name": "Facebook Marketplace Scraper",
    "slug": "facebook-marketplace-scraper"
  },
  "params": {
    "max_results": 200,
    "fetch_since": "24h",
    "exclude_outside_search": true,
    "listing_details": false
  },
  "concurrency": 1,
  "export_unique_results": true,
  "to_complete": true,
  "no_line_breaks": false,
  "status": "idle"
}
```
