Returns marketplace information and performance metrics for the specified creator.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Creator Open ID. More details
Query Parameters
Section titled “Query Parameters”Identifies the shop. Obtain it from the Get Authorized Shops API.
Creator data groups to include in the response. If omitted, all five groups are selected. Individual field availability remains subject to the documented market, permission, and availability conditions for each field. To request multiple groups, provide the values as a comma-separated query string, for example, BASIC_CREATOR_INFORMATION,CONTENT_PERFORMANCE. Available values:
- BASIC_CREATOR_INFORMATION: Basic creator profile information.
- CONTENT_PERFORMANCE: Content performance metrics, Promotion Performance Score (PPS), fulfillment score, and promoted product count.
- FOLLOWER_INFORMATION: Follower location, age, and gender distributions.
- COLLABORATION: Collaborated brands and commission information.
- SALES_AND_GMV: Units sold; GMV and GPM metrics and distributions; product price range; and average GMV per buyer.
Responses
Section titled “Responses”Success
object
Status code; 0 means success.
Success or failure message.
Request log ID.
object
Data associated with the creator’s TikTok profile.
object
TikTok user name.
TikTok nickname.
Metadata and data associated with the creator’s TikTok profile avatar.
object
The URL for the creator’s TikTok profile avatar.
The region where the creator selects products to promote.
The biography description associated with the creator.
The creator’s follower count.
The deep-link URI for the creator’s TikTok profile.
A list of category identifiers associated with the products for which the creator has created posts.
A list of the top 10 brands with which the creator has previously collaborated.
The total number of brands with which the creator has previously collaborated.
The total number of units sold. Units are indexed to SKU. Note that if the creator has not given permission for precise data sharing, this property will not be present.
The range of minimum number of units sold to maximum number of units sold over the lifetime of the creator account. Note that this property is included if the target market is US only. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The lowest number of units sold.
The highest number of units sold.
The formatted range of minimum number of units sold to maximum number of units sold over the lifetime of the creator account.
Gross merchandise value (GMV) metadata and data associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The ISO 4217 currency code for the GMV amount.
The amount of GMV
The video GMV metadata and data associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The total video GMV associated with the creator.
Livestream GMV metadata and data associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
Total livestream GMV associated with the creator.
The range of GMV values associated with this creator. Note that this property is included if the target market is US only. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The lowest GMV value.
The highest GMV value.
The formatted range of GMV values associated with this creator.
E-commerce live stream engagement rate in hundredths of a percent. For example, 6000 is 60%.
GMV distribution by category.
object
The top-level category identifier. A value of -1 represents all other categories.
The proportion of the creator’s GMV attributed to this category, expressed as a decimal from 0 to 1 (for example, 0.3035 = 30.35%).
GMV associated with creator content by content type.
object
The content type. This an enumerated type with values:
- VIDEO
- LIVE
- SHOWCASE
The proportion of the creator’s GMV attributed to this content type, expressed as a decimal from 0 to 1 (for example, 0.3035 = 30.35%).
The range of original prices for products promoted by the creator in the last 30 days.
object
The currency code.
The lowest original promoted product price.
The higest original promoted product price.
GMV per mille (GPM) metadata and data associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The GPM amount.
Livestream GMV per mille (GPM) metadata and data associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The livestream GPM amount.
Video GMV per mille (GPM) metadata and data associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The video GPM amount.
The range of GPM values associated with the creator. Note that this property is included if the target market is US. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The lowest GPM value.
The highest GPM value.
The formatted range of GPM values associated with the creator.
The range of video GPM values associted with the creator. Note that this property is included if the target market is US. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The lowest video GPM value.
The highest video GPM value.
The formatted range of video GPM values associted with the creator.
The range of livestream GPM values associted with the creator. Note that this property is included if the target market is US only. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The lowest livestream GPM value.
The highest livestream GPM value.
The formatted range of livestream GPM values associted with the creator.
The number of products promoted by the creator in the last 30 days.
The number of e-commerce livestreams associated with the creator in the last 30 days.
The number of e-commerce video posts associated with the creator in the last 30 days.
The average number of number of e-commerce video plays.
The average commission rate in hundredths of a percent. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
The range of average commission rates associated with the creator. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The smallest average commission rate in hundredths of a percent.
The largest average commission rate in hundredths of a percent.
Average GMV per buyer metadata and data associated with the creator. Note that this property is included if the target market is US only. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The average GMV per buyer amount.
The range of average GMV per buyer associated with the creator. Note that this property is included if the target market is US only. Note that if the creator has not given permission for precise data sharing, these properties will not be present.
object
The currency code.
The smallest average GMV per buyer.
The largest average GMV per buyer.
The formatted range of average GMV per buyer associated with the creator.
Average live stream views with promoted products.
Average e-commerce live stream likes.
Average e-commerce live stream comments.
Average e-commerce live stream shares.
Average e-commerce video likes.
Average e-commerce video comments.
Average e-commerce video shares.
A list of key–value pairs representing the distribution of followers by location.
object
The country code for the follower location (for example, ID).
The proportion of followers from this location, expressed as a decimal (e.g., 0.3705 = 37.05%).
A list of key–value pairs representing the distribution of followers by age range.
object
The age range (e.g., “18–23”).
The proportion of followers in this age range, expressed as a decimal (e.g., 0.2500 = 25.00%).
A list of key–value pairs representing the distribution of followers by gender.
object
The gender (e.g., “Male”, “Female”).
The proportion of followers of this gender, expressed as a decimal (e.g., 0.5000 = 50.00%).
Promotion Performance Score (PPS) The score reflects the quality of a creator’s shoppable content and product selection over the past 90 days. A high score may indicate a better shopping experience, with fewer potential refunds or negative reviews.
Rating from sellers who worked with this creator
The number of post engagements (likes, shares, and comments) divided by the total video views averaged across the videos in the last 30 days. For example, 3000 stands for 0.3 or 30%
The projected rate at which a creator is likely to post a shoppable video or LIVE after receiving a sample. For example, 3000 stands for 0.3 or 30%
Advanced creator profile information. An empty object means this information is not available for the caller’s account or region.
object
Creaor has official recommend tag or not
Is creator contact infomation available
Creator bind MCN name
Creator engagement rate last 30 days
Creator average VIDEO play count last 30 days
Creator average LIVE view count last 30 days
Creator LIVE like count last 30 days
Creator average LIVE comment count last 30 days
Creator average LIVE share count last 30 days
Creator average VIDEO publish count last 30 days
Has invited before 90 days
Is creator blocked by shop
Creator level
The number of fulfillment reviews submitted by sellers for the creator in the last 90 days.
Creator is eligible for flat fee invitation
Creator has rising star tag or not
Creator fulfillment score during last 90 days
Creator credit total score. e.g. 75 means creator’ sample scole is 75/100.
Creator connect infomation
object
Creator is paired or not
Creator is connect or not
Creator is blocked or not
Creator trend infomation
object
Trend start timestamp
Trend end timestamp
Trend GMV infomation
object
GMV amount
GMV symbol
Trend units sold
Trend follower
Trend engagement rate e.g. 558 means creator’s engagement rate is 5.58%
Example
{ "code": 0, "data": { "creator": { "username": "dioab", "nickname": "Dion", "avatar": { "url": "https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-giso/2bf6a2485ec8bf93483e4a6ed907e6fd~c5_720x720.webp?lk3s=a5d48078&x-expires=1712988000&x-signature=E8US22KfUCwKz0R%2FMFF6%2FMOmogs%3D" }, "selection_region": "US", "bio_description": "This is my personal introduction", "follower_count": 2323, "profile_tt_uri": "aweme://user/profile/7200669046446064666?sec_uid=MS4wLjABAAAAvkrSOIMxn2YpXW5qBFVHIbfQ11u2L1hamtgg3mbk5GRPpl1TrnKo5zzQe5T77YLw&from_scene=8&enter_from=scan", "category_ids": [ "60001" ], "top_collaborated_brand_ids": [ "8363021" ], "brand_collaboration_count": 76, "units_sold": 234, "units_sold_range": { "minimum_amount": 100, "maximum_amount": 1000, "formatted_range": "0-10" }, "gmv": { "currency": "USD", "amount": "3434.23" }, "video_gmv": { "currency": "USD", "amount": "39232.34" }, "live_gmv": { "currency": "USD", "amount": "3432.34" }, "gmv_range": { "currency": "USD", "minimum_amount": "1000.00", "maximum_amount": "10000.00", "formatted_range": "$0-$100" }, "ec_live_engagement_rate": "6000", "category_gmv_distribution": [ { "category_id": "66666", "value": "0.3035" } ], "content_gmv_distribution": [ { "content_type": "VIDEO", "value": "0.3035" } ], "product_original_price_range": { "currency": "USD", "minimum_amount": "2.59", "maximum_amount": "343.23" }, "gpm": { "currency": "USD", "amount": "10.23" }, "live_gpm": { "currency": "USD", "amount": "44.96" }, "video_gpm": { "currency": "USD", "amount": "28.89" }, "gpm_range": { "currency": "USD", "minimum_amount": "100.00", "maximum_amount": "1000.00", "formatted_range": "$0-$100" }, "video_gpm_range": { "currency": "USD", "minimum_amount": "100.00", "maximum_amount": "1000.00", "formatted_range": "$0-$100" }, "live_gpm_range": { "currency": "USD", "minimum_amount": "100.00", "maximum_amount": "1000.00", "formatted_range": "$0-$100" }, "promoted_product_num": 311, "ec_live_count": 12, "ec_video_count": 34, "avg_ec_video_play_count": 1234, "avg_commission_rate": 6000, "avg_commission_rate_range": { "minimum_amount": 6000, "maximum_amount": 7000 }, "avg_gmv_per_buyer": { "currency": "USD", "amount": "45.68" }, "avg_gmv_per_buyer_range": { "currency": "USD", "minimum_amount": "100.00", "maximum_amount": "1000.00", "formatted_range": "$15-$20" }, "avg_ec_live_view_count": 4355, "avg_ec_live_like_count": 344, "avg_ec_live_comment_count": 23, "avg_ec_live_share_count": 3434, "avg_ec_video_like_count": 324, "avg_ec_video_comment_count": 343, "avg_ec_video_share_count": 22, "follower_location": [ { "key": "ID", "value": "0.3705" } ], "follower_age": [ { "key": "18-23", "value": "0.2500" } ], "follower_gender": [ { "key": "Male", "value": "0.5000" } ], "pps": "4.5", "rating": "3.2", "ec_video_engagement_rate": "3000", "post_rate": "100", "creator_profile": { "is_official_recommend": false, "contact_info_available": false, "creator_bind_mcn_name": "name", "live_engagement_rate_30d": 50, "video_play_cnt_30d_med": 10, "live_view_cnt_30d_med": 10, "live_like_cnt_30d": 10, "live_comment_cnt_30d_med": 10, "live_share_cnt_30d_med": 10, "video_publish_cnt_30d_med": 10, "has_invited_90d": false, "is_creator_blocked": false, "creator_level": 2, "creator_fulfillment_reviews": 10, "is_eligible_flat_fee": false, "is_rising_star": false, "creator_fulfillment_score_90d": "4.1", "sample_score": 75, "creator_connect_info": { "is_paired": false, "is_connect": false, "is_blocked": false }, "creator_trend_profile": [ { "start_timestamp": 1784419200, "end_timestamp": 1784419200, "gmv": { "amount": "1000", "symbol": "$" }, "units_sold": 1000, "follower": 1000, "engagement_rate": 558 } ] } } }, "message": "Success", "request_id": "202203070749000101890810281E8C70B7"}