Creators

Creators are TikTok accounts indexed by Tokfluence, with stats, contact info, and cross-platform presence baked in.

GET/v1/creators/search#

Run the same filtered search the Tokfluence app uses. Results are paginated; per_page caps at 100.

Query parameters

Example

curl "https://developers.tokfluence.com/v1/creators/search?query=fitness&min_followers=50000&regions[]=US" \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "data": [
    {
      "id": "tkc_a1b2c3d4e5f6a7b8",
      "username": "alice",
      "bio": "Daily home workouts.",
      "picture": "https://...",
      "region": "US",
      "verified": false,
      "brand": false,
      "gender": "female",

      "has_email": true,
      "contact_email": "alice@example.com",
      "contact_emails": ["alice@example.com", "press@alice.tv"],
      "has_phone": true,
      "contact_phone": "+15551234567",
      "contact_phones": ["+15551234567"],

      "follower_count": 142000,
      "average_views_per_video": 38000,
      "engagement_rate": 0.052,
      "posts_per_week": 4.2,
      "video_count": 240,
      "total_likes": 7500000,
      "audience_regions": [{"id": "US", "share": 0.62}],
      "last_analyzed_at": "2026-05-19T11:02:17.553Z",

      "hashtags": ["fitness", "homeworkout"],
      "mentions": ["nike"],

      "youtube": {
        "subscribers": 12000,
        "channel_url": "https://youtube.com/@alice",
        "country": "US",
        "verified": true,
        "video_count": 90,
        "views": 4000000
      },
      "instagram": null
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 412,
    "total_pages": 21,
    "max_page": 500,
    "age_filter": {
      "enabled": true,
      "excluded_likely_minors": 0,
      "excluded": [],
      "note": "Creators whose own bio states an age under 18 are left out. …"
    }
  }
}

Creators who state they are under 18

Every search endpoint (/v1/creators/search, /v1/ai_search and /v1/creators/semantic_search) leaves out creators whose own bio states an age under 18, and lists each one it left out in meta.age_filter.excluded with the words that decided it. The index holds no age field, so this is read from the bio. A creator who states no age is neither checked nor cleared. The filter runs on the page after the search, so a page can hold fewer rows than per_page, and meta.total is not reduced for it.

The filter is always on and no parameter turns it off. Single-creator lookups apply it too: GET /v1/creators/:id and GET /v1/creators/:id/posts answer a creator whose bio states an age under 18 with 404 creator_not_found, exactly as for a creator we do not hold, and you are not charged.

Paging past 10,000 results

Page-based paging reads the first 10,000 matches of a search. meta.max_page tells you where that ceiling falls at your page size; asking for a page beyond it returns 422 page_out_of_range rather than an empty list, so a truncated crawl is never mistaken for an exhausted one.

To read a result set larger than that, pass cursor instead of page. Each response carries a meta.next_cursor; feed it back to get the next slice. Results are ordered by your sort (default follower_count_desc) with a stable tiebreaker, so no creator is skipped or repeated across the walk. When next_cursor comes back null, you have reached the end.

Start the walk with an empty cursor, as the loop below does. A cursor is the sort position of the last creator you received. It holds nothing on our side, so it does not expire and still works the next day. The index is live, though: a creator whose follower count changes between your calls can move across your position, so a walk spread over days can skip or repeat a few creators.

cursor=""
while :; do
  page=$(curl -sG "https://developers.tokfluence.com/v1/creators/search" \
    -H "Authorization: Bearer $TOKEN" \
    --data-urlencode "regions[]=BG" \
    --data-urlencode "min_followers=5000" \
    --data-urlencode "cursor=$cursor")

  echo "$page" | jq -r '.data[].username'

  cursor=$(echo "$page" | jq -r '.meta.next_cursor // empty')
  [ -z "$cursor" ] && break        # no cursor back = end of the result set
done

Cursor calls are priced the same way as page-based calls, and each returns up to per_page creators.

A search call costs 1 credit, plus 1 per profile with contact details it returns. Profiles without contact details are free, and an empty page costs nothing. Use has_email to control the cost: has_email=true returns only creators you can email, has_email=false&has_phone=false only creators without contact details, at 1 credit a page. See search billing.

Field reference

GET/v1/creators/:id#

Fetch a single creator's profile. :id can be a TikTok username (e.g. wwe) or a Tokfluence creator ID (tkc_…). The response carries every search field plus a recent_posts array of the creator's latest posts.

It returns what we hold and does not re-analyse the creator, so last_analyzed_at does not move. Calling recent posts on a creator we analysed long ago puts them in our scrape queue.

curl "https://developers.tokfluence.com/v1/creators/wwe" \
  -H "Authorization: Bearer $TOKEN"

GET/v1/creators/:id/posts#

Returns the creator's recent TikTok posts with stats, hashtags, mentions, and music metadata.

Query parameters

curl "https://developers.tokfluence.com/v1/creators/wwe/posts?limit=10" \
  -H "Authorization: Bearer $TOKEN"