TOOL API

identity_live_get

Retrieves live videos under a specified identity. Results are returned in reverse chronological order before the provided timestamp cursor. For pagination, start with `cursor=0`; the response returns `has_more` and `cursor`, and when `has_more` is `true`, use the returned `cursor` to request the next page.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

cursor

Timestamp cursor. Live videos before this timestamp are returned in reverse chronological order. In the initial request, set it to `0`. The response includes `has_more` and a `cursor`; if `has_more` is `true`, use the returned `cursor` in the next request to get the following page of data.

identity_authorized_bc_id

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

identity_idrequired

Identity ID.

identity_typerequired

Identity type. Enum values: `TT_USER`, `BC_AUTH_TT`. When `identity_type` is `BC_AUTH_TT`, `identity_authorized_bc_id` is required. See the Identity documentation for valid identity types and usage.