# Add Tasks

Add tasks to your Similarweb Scraper squid

Add domains or Similarweb URLs to your **Similarweb Scraper** squid.

<Note>Crawler ID: `ac02527b552b088c1f4ebe5a41d3d40a`</Note>

## 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="squid" type="string" required>
  Hash ID of your squid.
</ParamField>

<ParamField body="tasks" type="array" required>
  Array of task objects.
</ParamField>

## Task Fields

<ParamField body="tasks[].url" type="string" required>
  What to analyse. Four forms are accepted:

  - a bare domain: `github.com`
  - the website itself: `https://github.com/`
  - its Similarweb page: `https://www.similarweb.com/website/github.com/`
  - a Similarweb ranking: `https://www.similarweb.com/top-websites/france/news-and-media/` — every website of the ranking is collected, one row each.

  A ranking URL already carries its country and category: when it does, the `country` and `category` filters are ignored for that task.
</ParamField>

## Code Examples

<CodeGroup>
```bash cURL
curl -X POST https://api.lobstr.io/v1/tasks \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squid": "YOUR_SQUID_HASH",
    "tasks": [
      {"url": "github.com"}
    ]
  }'
```

```python Python
import requests

response = requests.post(
    "https://api.lobstr.io/v1/tasks",
    headers={
        "Authorization": "Token YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "squid": "YOUR_SQUID_HASH",
        "tasks": [
            {"url": "github.com"}
        ],
    },
)
print(response.json())
```
</CodeGroup>

## Response

```json 200
{"duplicated_count": 0, "tasks": [{"id": "TASK_HASH", "is_active": true, "params": {"url": "github.com"}, "object": "task"}]}
```
