工具 API

identity_video_get

Gets all TikTok posts under an identity through `/open_api/v1.3/identity/video/get/`. In v1.3, `advertiser_id` and `cursor` are strings, `item_type` was added, and response fields changed from v1.2 including `list` to `video_list`, `id` to `anchor_id`, string `item_id`, and new `carousel_info`. Depending on the identity type, pagination behavior differs: for `TT_USER` and `BC_AUTH_TT`, the response `cursor` is the time value of the last returned item; for `AUTH_CODE`, the response `cursor` is a pagination cursor used when `has_more` is `true`.

ecommerceOAuth1 积分

调用信息

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

输入参数

advertiser_id必填

Advertiser ID.

count

Number of TikTok posts to return. Value range: 1-20. If a value greater than 20 is specified, this field is ignored and at most 20 posts are returned.

cursor

Cursor for pagination. The corresponding response cursor behaves differently by `identity_type`: for `TT_USER` and `BC_AUTH_TT`, it is the time value of the last returned item; for `AUTH_CODE`, it is a pagination cursor to use for the next page when more data is available.

exclude_adsonly

Whether to exclude ads only posts from the results. Ads-only posts are those you publish from a TikTok account as ads, which remain hidden from the public on the account's profile page. Supported values: false: To retrieve both organic and ads only posts. true: To retrieve a maximum of 500 most recent organic posts. Default value: false.

identity_authorized_bc_id

Business Center ID associated with a TikTok Account User in Business Center identity. Required when `identity_type` is `BC_AUTH_TT`.

identity_id必填

Identity ID.

identity_type必填

Identity type. Valid values are `AUTH_CODE`, `TT_USER`, and `BC_AUTH_TT`. When `identity_type` is `BC_AUTH_TT`, you must also provide `identity_authorized_bc_id`. The `keyword` field is valid only when `identity_type` is `AUTH_CODE`; otherwise an error will occur.

item_type

Type of TikTok posts to retrieve. `VIDEO` returns video posts. `CAROUSEL` returns photo posts. Default value: `VIDEO`.

keyword

Valid only when `identity_type` is `AUTH_CODE`; otherwise, an error will occur. Use this field to search posts by text or by TikTok post ID. For text search, provide a string up to 500 characters; this supports multiple languages and fuzzy matching. For item ID search, provide a numeric string with a minimum length of 19 characters; this supports exact matching.