Introduction

The Tokfluence API gives you programmatic access to the same TikTok creator search, post analytics, and campaign tracking that powers the Tokfluence app. It's designed for teams that want to build directly on top of our index instead of clicking through the UI.

What you get

• Search a multi-million row creator index with the same filters the app exposes (followers, engagement, region, audience, verified, contact email, hashtags, mentions, cross-platform presence).
• Resolve a TikTok username to a full creator profile, including recent posts.
• Fetch TikTok post stats and comments by post ID.
• Submit batches of post URLs to the analysis pipeline.
• Create and read campaigns: collections of creators and the posts they delivered, with spend, GMV, and ROI math.

Base URL

All endpoints live under a single host:

https://developers.tokfluence.com/v1

Local development can use http://developers.tokfluence.test:3000/v1 after configuring /etc/hosts for the .test TLD.

Response shape

Successful responses always return a data field, plus optional meta for pagination, debit info, or rejection details:

GET /v1/creators/search?query=fitness

200 OK
X-Credits-Remaining: 9876

{
  "data": [
    {
      "id": "tkc_a1b2c3d4e5f6a7b8",
      "username": "alice",
      "follower_count": 142000,
      "engagement_rate": 0.052,
      ...
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 412,
    "total_pages": 21
  }
}

Errors use a single envelope with code + message. See Errors.

Out of scope today