TOOL API
identity_
Gets information for one or more TikTok posts published using the `AUTH_CODE`, `TT_USER`, or `BC_AUTH_TT` identity. Use `item_id` to retrieve a single post or `item_ids` to retrieve multiple posts. Endpoint path: `/v1.3/identity/video/info/`. Compared with v1.2, v1.3 changes `advertiser_id` and `item_id` from number to string, adds request parameters `item_ids` and `item_type`, renames response field `item_info` to `video_detail`, changes response `id` to string field `anchor_id`, and adds response fields `video_details`, `item_type`, and `carousel_info`.
Call information
- Tool slug
- tiktok-ads.identity_video_info_get
- Provider
- TikTok for Business
- Average response
- 0 ms
- Calls in 7 days
- 0
Input parameters
advertiser_idrequiredAdvertiser ID.
identity_authorized_bc_idRequired when `identity_type` is `BC_AUTH_TT`. ID of the Business Center associated with the TikTok Account User in Business Center identity.
identity_idrequiredIdentity ID for the selected `identity_type`. To get identities within an ad account, use `/identity/get/`.
identity_typerequiredIdentity type. Enum values: `AUTH_CODE`, `TT_USER`, `BC_AUTH_TT`. When `identity_type` is `BC_AUTH_TT`, `identity_authorized_bc_id` is required.
item_idEither `item_id` or `item_ids` must be specified. Use `item_id` to retrieve a single TikTok post. The post must be associated with the provided `identity_id`. To get valid post IDs, use `/identity/video/get/` and extract `item_id` from the response.
item_idsEither `item_id` or `item_ids` must be specified. Use `item_ids` to retrieve multiple TikTok posts. Each post ID must be associated with the provided `identity_id`. Max size: 20. To get valid post IDs, use `/identity/video/get/` and extract `item_id` from the response.