Skip to main content
POST
/
v1
/
tasks
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "squid": "<string>",
  "tasks": [
    {}
  ],
  "tasks[].url": "<string>"
}
'

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.

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

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Must be application/json. Value: application/json

​
Body

​
squid
string
required
Hash ID of your squid.
​
tasks
array
required
Array of task objects. Each task supports the fields below.

​
Task Fields

​
tasks[].url
string
required
Full TikTok video URL to scrape. Example: https://www.tiktok.com/@bellapoarch/video/6862153058223197445

​
Code Examples

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" }
    ]
  }'

​
Response

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"
    }
  ]
}