tiktok-creative-center/
creator-cards

The TikTok Creator Marketplace API looks up Creator Marketplace cards for up to 20 creators by ID: follower age, gender, country and device shares, median views, engagement and starting rate.

TikTok Creator Marketplace API

Up to 20 creators
Audience demographics
Starting rates
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

TikTok Creator Marketplace

A TikTok Creator Marketplace card is the profile brands see when evaluating a creator for paid work, combining the creator's bio and follower count with the age, gender, country and device mix of their followers, median views, engagement and growth rates, and the starting rate they list for a sponsored video. Those cards let brands compare creators on audience fit, typical performance and price in one view.

TikTok Creator Marketplace API Features

  • Four audience cutsaudience splits followers by age range, gender, country and phone brand, and every entry is a share from 0 to 1.
  • Performance benchmarksmetrics holds followers_count, median_views, engagement_rate, followers_growth_rate and six_second_view_rate.
  • Listed starting ratestarting_price returns the amount and currency the creator lists for a sponsored video, as a number you can calculate with.
  • Up to 20 creators per requestcreator_ids takes 1 to 20 Creator Marketplace IDs, and the TikTok Creator Marketplace API returns one card for each creator that has one.
  • Identity on every cardusername, name, bio text, avatar_url, region, tiktok_user_id, url and recent_video_ids tie a Marketplace ID back to a real account.

TikTok Creator Marketplace API Parameters

ParametersRequiredDescription
creator_idsRequiredOne to 20 Creator Marketplace IDs, such as creator_id values from TikTok Creative Center Top Videos results.

How to Use the TikTok Creator Marketplace API

Collect creator IDs from Top Videos, then read their cards with the TikTok Creator Marketplace API.

  1. Run TikTok Creative Center Top Videos and copy the creator_id of creators you want to evaluate.
  2. POST {"creator_ids": ["7011198409688219653", "7070293872819044358"]} to /v1/tiktok-creative-center/creator-cards.
  3. Poll GET /v1/tasks/{task_id} until status is succeeded and read one card per creator from results.items.
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"creator_ids":["7011198409688219653","7070293872819044358"]}'

# audience.ages, genders, countries and devices are shares from 0 to 1.

TikTok Creator Marketplace API Use Cases

  • Audience-fit screening: Compare audience.ages, genders and countries of a shortlist with the customer you want to reach, and drop creators whose followers sit in the wrong markets.
  • Cost-per-view comparison: Divide starting_price.amount by median_views from the TikTok Creator Marketplace API to compare what each creator's listed rate buys, instead of comparing follower counts.
  • Momentum ranking: Sort a shortlist by engagement_rate and followers_growth_rate to find creators who are both responsive and still gaining followers.

TikTok Creator Marketplace API Pro Tips

  • Take IDs from the creator_id field of Top Videos rows; a TikTok user ID such as author.id does not match a card and is skipped.
  • Treat each audience cut as a list of shares that can add up to slightly less than 1, and match entries by label rather than by position.
  • Read starting_price.amount together with currency and treat it as the creator's opening figure, since final rates are agreed per project.

Beyond the TikTok Creator Marketplace API, use these APIs when you need a different type of public TikTok Creative Center data.

Explore other platforms

Combine TikTok Creative Center data with public data from other supported social platforms.

TikTok Creator Marketplace API — FAQ

TikTok Creator Marketplace API is a programmatic interface for retrieving TikTok Creator Marketplace cards for up to 20 creators by their Creator Marketplace IDs. It returns follower age, gender, country and device breakdowns, median views, engagement and growth rates, starting rates and creator identity.

The Creator Marketplace ID, returned as creator_id in Top Videos rows, written as 5 to 32 digits. A regular TikTok user ID does not identify a card, and other formats are rejected with a 400 error.

Creators who have joined TikTok's Creator Marketplace and set up a profile; TikTok sets the eligibility, including age and follower thresholds that vary by project. An ID without a card is skipped and not charged, and if every ID is skipped the task fails and the credits are refunded. Each card returned costs 0.5 credits.

Four cuts of the creator's followers: age ranges with labels such as 18-24 or 55+, gender, country and phone brand, each entry with a share from 0 to 1. Countries also carry country_code and a count of sampled followers.

starting_price gives the amount and currency the creator lists as the starting price for a sponsored video. It is an opening figure: creators set their own starting rates and the final price is agreed per project.

No, the TikTok Creator Marketplace API looks up cards by Creator Marketplace ID. Candidates come from TikTok Creative Center Top Videos, where every chart row carries a creator_id.

Not from TikTok. The TikTok Creator Marketplace API runs on your SocQ API key alone, with no brand account or partner approval involved.