GMV Max

Is an identity or product already used by Shopping Ads

Changed on

TikTok's gmv_max/occupied_custom_shop_ads/list, read on the request. An identity or product (SPU) that enabled Video, Product or LIVE Shopping Ads already use cannot join a GMV Max campaign; occupied_by lists those ads. One asset per call. Single shop only.

get/gmv-max/asset-occupancy

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/gmv-max/asset-occupancy
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

asset_type'IDENTITY_TT_USER' | 'IDENTITY_BC_AUTH_TT' | 'IDENTITY_TTS_TT' | 'SPU' required

What asset_id is: an identity of that type, or a product (SPU).

asset_idstring required

The identity ID or SPU ID.

Response

Successful Response

shop_idinteger required
advertiser_idstring required
store_idstring required

This shop's TikTok Shop (store) ID.

source'live'

Always live: read from TikTok on the request.

fetched_atstring nullable required

Changes