工具 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 积分

调用信息

工具标识: tiktok-ads.tt_video_list_get
服务提供方: TikTok 广告
平均响应: 0 ms
近 7 天调用: 0

输入参数

advertiser_id必填

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.