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
| Param | Type | Notes |
|---|---|---|
query | string | Free text matched against tags, mentions, and bios. |
min_followers | int | Inclusive lower bound. |
max_followers | int | Inclusive upper bound. |
min_engagement_rate | float | e.g. 0.03 for 3%. |
regions[] | string[] | ISO-3166 alpha-2 country codes (uppercase). |
gender | string | male, female, humans, no_face, artificial_intelligence. |
is_tiktok_verified | bool | Verified accounts only. |
has_email | bool | Has a public contact email. |
hashtags[] | string[] | Without the # prefix. |
mentions[] | string[] | Without the @ prefix. |
has_youtube_linked | bool | Has a discoverable YouTube channel. |
has_instagram_linked | bool | Has a discoverable Instagram profile. |
sort | string | follower_count_desc, engagement_rate_desc, posts_per_week_desc, average_views_per_video_desc, or any of these with _asc. |
page | int | Defaults to 1. |
per_page | int | Defaults to 20, max 100. |
Example
bash
curl "https://developers.tokfluence.com/v1/creators/search?query=fitness&min_followers=50000®ions[]=US" \
-H "Authorization: Bearer $TOKEN"Response
json
{
"data": [
{
"id": "tkc_a1b2c3d4e5f6a7b8",
"username": "alice",
"bio": "Daily home workouts.",
"picture": "https://...",
"region": "US",
"verified": false,
"gender": "female",
"has_email": true,
"contact_email": "alice@example.com",
"contact_emails": ["alice@example.com", "press@alice.tv"],
"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}],
"hashtags": [{"value": "fitness", "count": 12}],
"mentions": [{"value": "nike", "count": 3}],
"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
}
}Field reference
| Param | Type | Notes |
|---|---|---|
id | string | Stable Tokfluence creator id (tkc_). |
username | string | Current TikTok username. |
bio | string | Profile biography text. |
picture | string | Profile picture URL. |
region | string | ISO-3166 alpha-2, derived from creator location or top audience country. |
verified | bool | TikTok verified badge. |
gender | string | Inferred from profile picture (male, female, no_face, etc.). |
has_email | bool | Whether any contact email is known. Useful as a filter without parsing the array. |
contact_email | string | Primary contact email when known, else null. |
contact_emails | string[] | All known contact emails, deduplicated. |
follower_count | int | TikTok followers. |
average_views_per_video | int | Mean views over recent posts. |
engagement_rate | float | 0–1, e.g. 0.052 = 5.2%. |
posts_per_week | float | Posting cadence. |
video_count | int | Total TikTok videos. |
total_likes | int | Lifetime hearts across all videos. |
audience_regions | object[] | Top audience countries with share. |
hashtags | object[] | Most-used hashtags, with frequency. |
mentions | object[] | Most-used @-mentions, with frequency. |
youtube | object | Linked YouTube channel info, or null. |
instagram | object | Linked Instagram profile info, or null. |
Contact emails are included by default
No separate "reveal email" call needed. The Developer plan covers email visibility through your standard credit budget — every
creators.search or creators.show response includes whatever emails we have on file. Use has_email=true in search to narrow down to creators who actually have one.
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_…).
bash
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
| Param | Type | Notes |
|---|---|---|
limit | int | Defaults to 24, max 50. |
Live data — may take a few seconds
This endpoint hits TikTok via our proxy network on cold cache, so it costs 25 credits and can take a few seconds the first time you ask for a creator. On a warm cache it returns immediately.
When the upstream needs to refresh stale data, the response is
202 with code: "analysis_pending" and a Retry-After header. You are not charged for the 202 — the credits come back. Retry after the suggested delay and the warm-cache hit will be billed normally.
bash
curl "https://developers.tokfluence.com/v1/creators/wwe/posts?limit=10" \
-H "Authorization: Bearer $TOKEN"