TOOL API

tt_video_list_get

Gets a list of Spark Ads posts that have been authorized to an ad account. Endpoint path: /v1.3/tt_video/list/. Compared with v1.2, `advertiser_id` changed from number to string, `item_types` was added, and response fields changed including `video_info.url` renamed to `video_info.preview_url` and several IDs/timestamps changed to string types.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

The advertiser ID.

item_types

Filters by Spark Ads post type. Allowed values: `VIDEO` for video posts and `CAROUSEL` for photo posts. If omitted, the default is `["VIDEO", "CAROUSEL"]`.

keyword

Search keyword for TikTok posts. To search by post text, provide a string up to 500 characters; this supports multilingual and fuzzy matching. To search by `item_id`, provide a numeric string with a minimum length of 19 characters; this supports exact matching.

page

Current page number. Default is `1`. Must be greater than or equal to 1.

page_size

Page size. Default is `20`. Must be between 1 and 50.