TOOL API

spark_ad_recommend_get

Returns Spark Ads recommendation results for up to 100 video posts associated with a TikTok One (TTO) Creator Marketplace account. The endpoint analyzes videos associated with the TTO Creator Marketplace account in the past year and assigns recommendation scores and levels based on audience interactions, preferences, video attributes such as genre and length, and historical performance. For meaningful results, TikTok recommends using a TTO Creator Marketplace account associated with at least 10 video posts in the past year. If the account has more than 100 associated video posts in the past year, only the top 100 videos with the highest Spark Ads potential are returned. This endpoint requires an Access-Token authorized by a TTO Creator Marketplace account; to obtain one, see https://business-api.tiktok.com/portal/docs?id=1825117875361793.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.spark_ad_recommend_get
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

exclude_video_ids

List of video post IDs to exclude from analysis. To analyze all video posts associated with the TTO Creator Marketplace account in the past year, do not pass `video_ids` or `exclude_video_ids`. To narrow the analysis scope, pass either `video_ids` or `exclude_video_ids`. Specify IDs of video posts belonging to TTO campaigns associated with the TTO Creator Marketplace account. Max size: 100.

objective_type

Advertising objective to use when generating recommendations. If omitted, advertising objectives are not factored into recommendation results. If specified, you can create a campaign with the same `objective_type` via `/campaign/create/` and use a recommended post in ads by setting `tiktok_item_id` to a recommended `item_id` in `/ad/create/`.

tcm_account_idrequired

The ID of a TTO Creator Marketplace account. Required to receive Spark Ads recommendations for videos associated with that account.

time

Filters videos by publish time. If omitted, all videos published at any time are analyzed. If `video_ids` and `time` are passed together, `time` is ignored. You can use `exclude_video_ids` and `time` together.

video_ids

List of video post IDs to analyze exclusively. To analyze all video posts associated with the TTO Creator Marketplace account in the past year, do not pass `video_ids` or `exclude_video_ids`. To narrow the analysis scope, pass either `video_ids` or `exclude_video_ids`. The returned `recommendation_level` for each video is relative to the provided video set, so the same video can receive different recommendation levels under different input sets. Specify IDs of video posts belonging to TTO campaigns associated with the TTO Creator Marketplace account. Max size: 100.