Examples
Add Tasks
Add tasks to your TikTok Video Scraper squid
The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POST
https://api.lobstr.io/v1/tasksAdd URLs or inputs to your TikTok Video Scraper squid. Each task object must include the required fields below.
Crawler ID:
1e6cba50f2713539a2b0ac784184ed92Headers
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY
Content-TypestringheaderrequiredMust be application/json. Value: application/json
Body
squidstringrequiredHash ID of your squid.
tasksarrayrequiredArray of task objects. Each task supports the fields below.
Task Fields
tasks[].urlstringrequiredFull 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" } ] }