> ## 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 Twitter User Tweets Scraper settings

Configure your Twitter User Tweets Scraper squid settings. Control the number of tweets to fetch, time filtering, and whether to include retweets and pinned tweets.

## 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                                                                                                                                                                                                                       |
| --------------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **json**                    | boolean | false   | If true, returns the complete raw JSON payload for each tweet                                                                                                                                                                     |
| **max\_results**            | integer | null    | Maximum number of tweets to scrape per user                                                                                                                                                                                       |
| **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). |
| **exclude\_reposts**        | boolean | false   | If true, excludes retweets from results                                                                                                                                                                                           |
| **collect\_pinned\_tweets** | boolean | false   | If true, includes pinned tweets in results                                                                                                                                                                                        |

## 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` to monitor recent activity - set to `24` to only collect tweets from the last day.
</Tip>

<Tip>
  Enable `exclude_reposts` to focus on original content only.
</Tip>

<Note>
  Pinned tweets are not collected by default - enable `collect_pinned_tweets` if you need them.
</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": "Twitter User Tweets Scraper (2)",
      "concurrency": 1,
      "export_unique_results": true,
      "to_complete": false,
      "no_line_breaks": true,
      "params": {
        "json": true,
        "fetch_since": null,
        "max_results": 98,
        "exclude_reposts": true,
        "collect_pinned_tweets": true
      }
    }'
  ```

  ```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_id = "YOUR_SQUID_HASH"

  # Update scraper settings
  response = requests.post(f"{BASE_URL}/squids/{squid_id}",
      headers=headers,
      json={
          "name": "Twitter User Tweets Scraper (2)",
          "concurrency": 1,
          "export_unique_results": True,
          "to_complete": False,
          "no_line_breaks": True,
          "params": {
              "json": True,              # Return raw JSON from Twitter API
              "fetch_since": None,        # No time limit (fetch all)
              "max_results": 98,         # Maximum tweets per user
              "exclude_reposts": True,   # Don't include retweets
              "collect_pinned_tweets": True  # Include pinned tweets
          }
      }
  )

  print(response.json())
  ```
</CodeGroup>

## Response

```json 201 theme={null}
{
  "name": "Twitter User Tweets Scraper (2)",
  "no_line_breaks": true,
  "params": {
    "json": true,
    "fetch_since": null,
    "max_results": 98,
    "exclude_reposts": true,
    "collect_pinned_tweets": true
  },
  "to_complete": false,
  "export_unique_results": true
}
```