TOOL API

showcase_product_get

Gets the Showcase products that are available for targeting the specified countries or regions. The request must use an identity bound to the Showcase and that identity must have permission to access the Showcase.

ecommerceOAuth1 credits

Call information

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

Input parameters

advertiser_idrequired

Advertiser ID.

filtering

Optional filtering conditions for narrowing the returned Showcase products.

identity_authorized_bc_id

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

identity_idrequired

ID of the identity bound to the Showcase. The identity must have permission for the Showcase.

identity_typerequired

Type of identity. Enum values: `TT_USER` for a TikTok User; `BC_AUTH_TT` for a TikTok Account User in Business Center. Required companion field: when `identity_type` is `BC_AUTH_TT`, you must also provide `identity_authorized_bc_id`.

page

Current page number. Defaults to `1` if omitted. Value range: >= 1.

page_size

Number of results per page. Defaults to `10` if omitted. Value range: `1` to `1000`.

region_codesrequired

List of country or region codes for which you want to retrieve Showcase products that can be used for targeting.