TOOL 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 credits

Call information

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

Input parameters

advertiser_idrequired

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_idrequired

Identity ID.

identity_typerequired

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.