Skip to main content
POST
TikTok Creator Marketplace API

TikTok Creator Marketplace

Pull the Creator Marketplace card for creators you are evaluating: the age, gender, country and device mix of their followers, median views, engagement rate, follower growth and the starting rate they list for a sponsored video. Send the creator_id values from TikTok Creative Center Top Videos, up to 20 at a time.
creator_ids is required: 1 to 20 Creator Marketplace IDs, such as creator_id values from TikTok Creative Center Top Videos. Each creator with a card returns one result, billed per result.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

creator_ids is required: 1 to 20 Creator Marketplace IDs, such as creator_id values from TikTok Creative Center Top Videos results. Returns one card per creator with audience demographics, performance benchmarks and rates.

creator_ids
string[]
required

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

Required array length: 1 - 20 elements
Pattern: ^[0-9]{5,32}$
callback_url
string<uri>

Response

Task accepted

code
integer
data
object