Crawl TikTok for a niche we do not cover yet
create_seed_campaignStarts a keyword-seeded crawl of TikTok to find creators the index does not have yet. Give it hashtags, it walks them, discovers creators, and adds the ones that fit the niche to the index where search_creators can find them.
Use this only after search_creators has come up short: a niche that returns almost nothing at niche_level "wide", or a country where the supply is obviously thinner than it should be. If search already returns hundreds of plausible creators, a crawl will mostly rediscover them and you have spent credits for nothing. Curation beats crawling on any niche that is already covered.
It is not instant. A campaign runs for hours and results arrive gradually, so the shape of the work is: start the campaign, carry on building the list from what is already in the index, then check back with get_seed_campaign later and search again.
Run suggest_campaign_keywords first and seed from what it returns. Guessed tags are reliably worse: asked for bladder health a person writes #pelvicfloor, #womenshealth, #bladderhealth, while the creators themselves post under #kegels, #prolapse, #incontinence and #urinaryincontinence, and #womenshealth is on so many profiles that it steers nothing.
More good seeds is better, not worse. Each one is a frontier row, and the crawl only compounds when a seed turns up high-lift neighbouring tags to follow. Seven guessed tags stall; fifteen mined ones keep going.
THIS SPENDS THE USER'S MONEY, SO IT IS TWO STEPS.
Call it first without confirm. Nothing is started and nothing is charged: you get
back exactly what would be crawled, what it costs, and what the user's balance is.
Put that in front of the user in your own words and wait for a clear yes. Only then
call again with confirm: true and the same arguments.
Never pass confirm: true on the first call, and never infer consent from an
earlier "go ahead" about something else. The user agreeing to build a list is not
the user agreeing to spend 250 credits
on a crawl.
Max 3 campaigns running at once per account.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"keywords": "<keywords>"
},
"name": "create_seed_campaign"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | What this campaign is looking for, e.g. 'UK bladder health creators'. | |
| start | No | Start crawling immediately. Default true; false leaves it as a draft. | |
| region | No | ISO-3166 alpha-2 country code to bias discovery toward, e.g. 'BG'. A soft preference for ranking the crawl frontier, not a hard filter. | |
| confirm | No | Set only after the user has seen the cost and said yes. Omit on the first call to get the confirmation details. | |
| keywords | Yes | TikTok hashtags without '#', max 20. Use the tags creators actually post under. | |
| max_depth | No | How far to walk from the seed tags. Default 2. Raise for a wider sweep, at proportional cost. | |
| max_profiles | No | Stop after scraping this many profiles. Default 5000. | |
| min_followers | No | Skip creators below this follower count. Default 1000. |