Search the Tokfluence TikTok creator index (millions of profiles) by keyword and structured filters. This is the primary tool: use it to build a candidate pool, then narrow it yourself.

How to get good results:

• A brief with more than one requirement goes in concepts, not query. "Curly hair creators over 40" is two requirements, and asking for it as one keyword returns curly-hair creators of any age mixed with over-40 creators with any hair. concepts: ["curly hair", "over 40"] requires both.

• Run several searches with different keywords rather than one search with a long keyword string. The index matches creator bios, hashtags and captions, so "postpartum" and "pelvic floor" find different people and the union is the pool.

• Start wide and tighten. A first pass with only query and min_followers tells you how much supply exists; add filters once you can see the shape of it.

• regions is the filter most likely to hide people from you. Creators we hold no country for are removed by it even though nothing says they are in the wrong place. Read region_filter in the response: when the number it reports dwarfs your result count, search without regions and read location off the bios.

• niche_level controls how hard a keyword has to bind. "wide" matches a creator who used the tag once, "laser" only creators the tag actually defines. Default "balanced". Drop to "wide" when a niche returns almost nothing.

• Results are relevance-ranked by default, so page 1 is the index's best guess. It is a guess: keep reading with page until you have a pool several times larger than the list you intend to deliver, then rank it yourself.

• Passing sort replaces relevance ranking with that ordering. Useful to answer "who are the biggest creators here", bad for finding the right ones. Once sorted you are descending through reach, not fit, so on-brief hits thin out as you page and that is NOT the niche running out. Judge coverage unsorted. The response says so in ranking whenever sort is combined with a keyword.

• Creators who state a minor's age in their bio are always excluded, and nothing turns that off. About half state no age at all; those come back marked age_unknown and have NOT been cleared. For a paid-promo brief, read their bios before you deliver them.

• Contact emails are stored unvalidated, so some of them are not addresses at all. Read contact_email_confidence on each row and send only to has_validated_email. A bounce costs the customer their own sending reputation.

• Results are a starting point, not a verdict. Rank the pool yourself on the evidence in each row (bio wording, hashtags, engagement against follower count), and call get_creator_posts on the handful you are unsure about.

Every response carries a coverage verdict saying whether the index really covers this niche and what to do next. Follow it. When it reports a genuine gap, tell the user what you found and offer to start a crawl; never start one without asking.

Set include_images to show the creators' profile pictures inline in the chat. Use it when you are presenting a shortlist to the user, who is choosing people to work with and should be able to see them. Leave it off while you are sweeping pages to build a pool, where nobody is looking at the intermediate results.

A search call costs 1 credit, plus 1 per profile with contact details it returns (a contact email or phone in the row). Rows without contact details are free, and an empty page costs nothing. Every page is its own call. Control the cost with the contact filters: has_email: true returns only creators with an email, so every credit buys someone you can reach; has_email: false and has_phone: false return only creators without, at 1 credit a page. Creators removed for stating a minor's age are not charged. When the balance cannot cover every profile with contact details, the page is still returned whole: the profiles it could not pay for come back without their contact values, and billing says how many.