# Add Tasks

Add tasks to your TikTok Video Scraper squid

Add URLs or inputs to your **TikTok Video Scraper** squid. Each task object must include the required fields below.

<Note>Crawler ID: `1e6cba50f2713539a2b0ac784184ed92`</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. Each task supports the fields below.
</ParamField>

## Task Fields

<ParamField body="tasks[].url" type="string" required>
  Full TikTok video URL to scrape. Example: `https://www.tiktok.com/@bellapoarch/video/6862153058223197445`
</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": "https://www.tiktok.com/@bellapoarch/video/6862153058223197445" },
      { "url": "https://www.tiktok.com/@username/video/7234567890123456789" }
    ]
  }'
```

```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}/tasks",
    headers=headers,
    json={
        "squid": squid_hash,
        "tasks": [
            {"url": "https://www.tiktok.com/@bellapoarch/video/6862153058223197445"},
            {"url": "https://www.tiktok.com/@username/video/7234567890123456789"}
        ]
    }
)

data = response.json()
print(f"Added {len(data['tasks'])} tasks")
for task in data["tasks"]:
    print(f"  {task['id']}: {task['params']['url']}")
```
</CodeGroup>

## Response

```json 200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "created_at": "2025-06-24T11:11:30.222467",
      "is_active": true,
      "params": {
        "url": "https://www.tiktok.com/@bellapoarch/video/6862153058223197445"
      },
      "object": "task"
    }
  ]
}
```
