> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Settings

> Configure the TripAdvisor Reviews Scraper parameters including filters for language, ratings, and date range

Configure your TripAdvisor Reviews Scraper squid settings to control review collection limits and apply filters by language, rating, and recency. These settings help you target specific review types and optimize credit usage.

## 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\_results**                   | integer | unlimited     | Maximum number of reviews to collect per listing                                                                                                                                                                                  |
| **max\_unique\_results\_per\_run** | integer | unlimited     | Maximum unique reviews across all tasks in the run                                                                                                                                                                                |
| **language**                       | string  | All languages | Filter reviews by language (e.g., `English`, `French`, `German`)                                                                                                                                                                  |
| **ratings**                        | string  | All ratings   | Filter by star rating: `1`, `2`, `3`, `4`, `5`                                                                                                                                                                                    |
| **fetch\_since**                   | string  | null          | Stop scraping when items older than this threshold are reached (based on `published_at`). 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](/docs/timezones). |

## 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>
  Use the language and ratings filters to collect only high-quality reviews in your target language, reducing noise and credit consumption.
</Tip>

<Tip>
  Set `fetch_since` to `null` for all reviews, or use a relative duration (`"24h"`, `"7d"`, `"2w"`) or absolute date (`"YYYY-MM-DD HH:MM"`) to collect only recent reviews. When using an absolute date, set `fetch_since_timezone` to interpret it in the correct timezone (e.g. `"Europe/Paris"`).
</Tip>

<Note>
  Reviews include subratings (Value, Rooms, Location, Cleanliness, Service, Sleep Quality) for hotels, providing detailed insights beyond the overall rating.
</Note>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  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": "TripAdvisor Reviews - NYC Hotels",
      "params": {
        "max_results": 100,
        "language": "English",
        "ratings": "5",
        "fetch_since": null,
        "fetch_since_timezone": null
      }
    }'
  ```

  ```python Python theme={null}
  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"

  # Update TripAdvisor Reviews Scraper settings
  response = requests.post(f"{BASE_URL}/squids/{squid_hash}",
      headers=headers,
      json={
          "name": "TripAdvisor Reviews - NYC Hotels",
          "params": {
              "max_results": 100,
              "language": "English",
              "ratings": "5",
              "fetch_since": None,  # relative: "7d", absolute: "2026-01-01 00:00:00"
              "fetch_since_timezone": None  # e.g. "Europe/Paris" — only used with absolute fetch_since
          }
      }
  )

  data = response.json()
  print(f"Squid updated: {data['name']}")
  print(f"Max results per task: {data['params']['max_results']}")
  print(f"Language filter: {data['params']['language']}")
  print(f"Rating filter: {data['params']['ratings']}")
  ```
</CodeGroup>

## Response

```json 201 theme={null}
{
  "id": "c7ea965333d54a949a9e74ba62029098",
  "name": "TripAdvisor Reviews - NYC Hotels",
  "crawler": {
    "id": 132,
    "name": "TripAdvisor Reviews Scraper",
    "slug": "tripadvisor-reviews-scraper"
  },
  "params": {
    "max_results": 100,
    "language": "English",
    "ratings": "5",
    "fetch_since": null,
    "fetch_since_timezone": null
  },
  "concurrency": 5,
  "export_unique_results": true,
  "to_complete": true,
  "no_line_breaks": false,
  "status": "idle",
  "created_at": "2025-01-20T10:15:00.000000",
  "updated_at": "2025-01-27T14:35:00.000000"
}
```