TOOL API

identity_get

Gets the list of identities under an ad account from /open_api/v1.3/identity/get/. You can filter results by identity type or display name. In v1.3, the endpoint path changed from /v1.2/identity/get/ to /v1.3/identity/get/, `advertiser_id` changed from number to string, and the response field `list` was renamed to `identity_list`.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

filtering

Filtering conditions. Valid only when `identity_type` is `CUSTOMIZED_USER` or when `identity_type` is omitted.

identity_authorized_bc_id

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

identity_type

Identity type. If omitted, all identities are returned. When set to `BC_AUTH_TT` and `identity_authorized_bc_id` is also specified, all identities linked to the ad account (`advertiser_id`) are returned.

page

Current page number. Default is `1`.

page_size

Number of results per page. Range: `1`-`100`. Default is `20`.