Seller Search Creator on Marketplace

This API is used by Sellers to search for Creators in the Creator Marketplace. Sellers can search based on filters such as GMV, keywords, and Creator follower demographics. All the data returned is for the last 30 days.

---

For common parameters, refer to How to call TikTok Shop APIs - Common Parameters

• Generally, a value greater than or equal to 0 needs to be passed. If a value less than 0 is passed, it means that the field will not be filtered. | ^gender_distribution |object |N | |Filtering creators by follower gender which includes: "male", "female" | ^^gender |string |N |MALE |A particular gender, "MALE" or "FEMALE" | ^^percentage_ge |int |N |6000 |Greater than or equal to a certain percentage, scaled up by 10,000 times. For example, 6000 stands for 0.6 or 60% | gmv_ranges |[]string |N |["GMV_RANGE_0_100", "GMV_RANGE_100_1000"] |Filtering by GMV range intervals which include: GMV_RANGE_0_100: "0-100", GMV_RANGE_100_1000: "100-1000", GMV_RANGE_1000_10000: "1000-10000", GMV_RANGE_10000_AND_ABOVE: "10000+" For example:
• If GMV_RANGE_0_100 is passed, it means filtering the creator data that is greater than or equal to 0 and less than or equal to 100.
• If GMV_RANGE_0_100 and GMV_RANGE_100_1000 are passed, it means to filter the creator data that is greater than or equal to 0 and less than or equal to 1000. | units_sold_ranges |[]string |N |["UNITS_SOLD_RANGE_0_10", "UNITS_SOLD_RANGE_100_1000","UNITS_SOLD_RANGE_1000_AND_ABOVE"] |Filtering by sales volume range intervals which include: UNITS_SOLD_RANGE_0_10: "0-10", UNITS_SOLD_RANGE_10_100: "10-100", UNITS_SOLD_RANGE_100_1000: "100-1000", UNITS_SOLD_RANGE_1000_AND_ABOVE: "1000+" For example:
• If UNITS_SOLD_RANGE_0_10 is passed, it means filtering the creator data that is greater than or equal to 0 and less than or equal to 10.
• If UNITS_SOLD_RANGE_0_10 and UNITS_SOLD_RANGE_10_100 are passed, it means to filter the creator data that is greater than or equal to 0 and less than or equal to 100. | category |[]object |N | |Object for category filters: Get Categories | ^parent_category_id |string |N |600001 |Category of the parent category. If you are only using a parent category, you do not need to pass in a child category ID. | ^child_category_id_list |[]string |N |["851848"] |If you are using the category ID for a child category, you must pass the parent category as well. A child category is only 1 level deeper than the parent category. We do not support going deeper down the category tree (some countries have 4 levels, others have 7) | content_performance |object |N | |Object containing content performance filters | ^avg_video_views |string |N |1 |Average Video Views more than You can pass in average video views anywhere between 0 and 100k Pick any whole number between 0 and 100,000, and we will return all results with average video views greater than that number. You can only pass in Average Video Views OR Average Shoppable Video Views. Using both filters will cause the API call to fail. | ^avg_shoppable_video_views |string |N |1 |You can pass in average shoppable video views anywhere between 0 and 100k Pick any whole number between 0 and 100,000, and we will return all results with average shoppable video views greater than that number. You can only pass in Average Video Views OR Average Shoppable Video Views. Using both filters will cause the API call to fail. | ^avg_engagement_rate |string |N |1 |Average engagement rate more than 0-20. You can only filter by increments of 1% point, up to 20%. | ^avg_shopable_engagement_rate |string |N |1 |Average shoppable engagement rate more than 0-20. You can only filter by increments of 1% point, up to 20%. | ^avg_live_avg_viewers_ge |string |N |1 |Average LIVE views greater than or equal to Pick any whole number between 0 and 100,000, and we will return all results with average video views greater than that number. You can only pass in average LIVE or average shoppable LIVE. Using both filters will cause the API call to fail | ^avg_shoppable_live_avg_viewers_ge |string |N |1 |Average shoppable LIVE viewers greater than or equal to Pick any whole number between 0 and 100,000, and we will return all results with average video views greater than that number. You can only pass in average LIVE or average shoppable LIVE. Using both filters will cause the API call to fail | affiliate_data |object |N | |Object which contains affiliate based data | ^avg_commission_rate |string |N |LESS_THAN_20% |- ALL
• LESS_THAN_20%
• LESS_THAN_15%
• LESS_THAN_10%
• LESS_THAN_5% Creator's average commission rate range based on showcase products, sales, and promoted products in the last 30 days. You can only pick one value. | ^post_rate |string |N |GOOD |These categories represent how often a creator posts a shoppable video or LIVE after receiving a sample.
• All
• OK
• GOOD
• BETTER Every country has its own benchmark based on what is a GOOD vs BETTER fulfillment rate. BETTER is always going to have the highest fulfillment rate, including 100% fulfillment rate. | ^creator_agency_staus |string |N |AGENCY_MANAGED |- AGENCY_MANAGED
• INDEPENDENT | ^is_fast_growing |bool |N |false |Top 10% of creators with the greatest increase in transactions, revenue, shoppable videos, live views, or followers in the last 30 days | ^not_invited_l90_days |bool |N |false |True/False Select this filter to see creators you haven't invited in the last 90 days | advanced_filters |object |N | |Advanced filters are specific to each country. We will provide a separate endpoint which allows you to query which filters are available for which country. | ^content_preference_type |[]string |N |["VIDEO"] |Content preference type. e.g. -VIDEO -LIVE | ^eligible_flat_fee |bool |N |false |Creator is eligible for flat fee invitation, only available in US local seller | ^option_list |[]object |N | |Creator Marketplace Advanced Filter Option List. Please use "Get Seller Search Creator Marketplace Advanced Filters"(https://partner.tiktokshop.com/docv2/page/get-seller-search-creator-marketplace-advanced-filters) get available options for you first | ^^options |[]object |N | |Options in this option type | ^^^id |string |N |1 |Option id | ^^^name |string |N |English |Option name | ^^^option_children |[]object |N | |Children Option | ^^^^id |string |N |2 |Option id | ^^^^name |string |N |SubTypeName |Option name, used if the option has sub-type choices. | ^^option_type |string |N |OPTION_LANGUAGE |option type | ^sorter_algorithm_id |string |N |1 |Sorter algorithm id. Please use "Get Seller Search Creator Marketplace Advanced Filters"(https://partner.tiktokshop.com/docv2/page/get-seller-search-creator-marketplace-advanced-filters) get available sorter algorithm for you first. Default is 1(default sorter) | data_groups |[]string |N |["BASIC_CREATOR_INFORMATION","SALES_AND_GMV"] |Creator's Data Group, get all group by default, which include:
• BASIC_CREATOR_INFORMATION
• CONTENT_PERFORMANCE
• FOLLOWER_INFORMATION
• COLLABORATION
• SALES_AND_GMV |

Query

https://open-api.tiktokglobalshop.com/affiliate_seller/202608/marketplace_creators/search?app_key=123abc&sign=5361235029d141222525e303d742f9e38aea052d10896d3197ab9d6233730b8c&timestamp=1625484268&shop_cipher=ROW_RHkDDABBAAB8tKAVoAqsMTjsQZFLyNfY&page_token=b2Zmc2V0PTAK&page_size=12

Body

{"search_key":"2E+0EcXoSk2HWdEWh2nITfkBRMbwuug0mt9s3fWgV0k=","keyword":"JefreeStar","follower_demographics":{"age_ranges":["AGE_RANGE_18_24","AGE_RANGE_35_44"],"count_range":{"count_ge":1000,"count_le":10000},"gender_distribution":{"gender":"MALE","percentage_ge":6000}},"gmv_ranges":["GMV_RANGE_0_100","GMV_RANGE_100_1000"],"units_sold_ranges":["UNITS_SOLD_RANGE_0_10","UNITS_SOLD_RANGE_100_1000","UNITS_SOLD_RANGE_1000_AND_ABOVE"],"category":[{"parent_category_id":"600001","child_category_id_list":["851848"]}],"content_performance":{"avg_video_views":"1","avg_shoppable_video_views":"1","avg_engagement_rate":"1","avg_shopable_engagement_rate":"1","avg_live_avg_viewers_ge":"1","avg_shoppable_live_avg_viewers_ge":"1"},"affiliate_data":{"avg_commission_rate":"LESS_THAN_20%","post_rate":"GOOD","creator_agency_staus":"AGENCY_MANAGED","is_fast_growing":false,"not_invited_l90_days":false},"advanced_filters":{"content_preference_type":["VIDEO"],"eligible_flat_fee":false,"option_list":[{"options":[{"id":"1","name":"English","option_children":[{"id":"2","name":"SubTypeName"}]}],"option_type":"OPTION_LANGUAGE"}],"sorter_algorithm_id":"1"},"data_groups":["BASIC_CREATOR_INFORMATION","SALES_AND_GMV"]}

{"code":0,"data":{"next_page_token":"b2Zmc2V0PTEw","search_key":"k1ChOzI9e+j5BHHHEnt+VhItjVFEkPUCCXNsrU8/v4U=","creators":[{"username":"abc","nickname":"cde","avatar":{"url":"https://p16-sign-useast2a.tiktokcdn.com/tos-useast2a-avt-0068-giso/2bf6a2485ec8bf93483e4a6ed907e6fd~c5_720x720.webp?lk3s=a5d48078\\u0026x-expires=1712988000\\u0026x-signature=E8US22KfUCwKz0R%2FMFF6%2FMOmogs%3D"},"selection_region":"GB","category_ids":["60001"],"avg_ec_live_uv":1331,"avg_ec_video_view_count":112,"follower_count":23241,"gmv":{"currency":"USD","amount":"1232.90"},"live_gmv":{"currency":"USD","amount":"0.34"},"video_gmv":{"currency":"USD","amount":"23.34"},"gmv_range":{"currency":"USD","minimum_amount":"1.00","maximum_amount":"100.34","formatted_range":"$0-$100"},"units_sold_range":{"minimum_amount":100,"maximum_amount":1000,"formatted_range":"$0-$100"},"top_follower_demographics":{"age_ranges":["AGE_RANGE_18_24","AGE_RANGE_25_34"],"major_gender":{"gender":"FEMALE","percentage":6524}},"creator_open_id":"uACafQAAAABmUU2qon4R0vUYvUVS3QC6CICP2m5A2-wd77j8R9G0yg","creator_profile":{"is_official_recommend":false,"creator_bind_mcn_name":"name","is_fast_growing":false,"has_collaborated":false,"user_type_tag":[1],"has_invited_90d":false,"is_creator_blocked":false,"pps_score":"4.3","is_eligible_flat_fee":false,"is_rising_star":false,"creator_level":2}}]},"message":"Success","request_id":"202203070749000101890810281E8C70B7"}

For common error codes, refer to How to call TikTok Shop APIs - Common Error Code