POST/v1/tasks

Add Tasks

Add keyword search tasks to extract top ads from TikTok

Add keyword-based search tasks to your squid. The scraper will extract top performing ads from TikTok's Creative Center based on your search terms.

Headers

KeyValueRequired
AuthorizationToken YOUR_API_KEYYes
Content-Typeapplication/jsonYes

Request Body

squid
Type:
string
Required:
Yes
Description:
Hash of your squid configured with the tiktok-top-ads-scraper crawler
tasks
Type:
array
Required:
Yes
Description:
Array of task objects, each containing a `keyword` field

Task Fields

keyword
Type:
string
Required:
Yes
Description:
Search term you want to get TikTok Ads from (e.g., "fitness", "skincare", "cooking")
Pro Tip

Pro Tip

Use specific keywords related to your industry or niche for more relevant ad results.
Pro Tip

Pro Tip

You can add multiple keywords in a single request to analyze ads across different topics.
Note

Note

Results are retrieved from TikTok's Creative Center Top Ads library.