GMV Max

This store's products and whether each can join GMV Max

Changed on

TikTok's store/product/get, read on the request: products with price, sales, stock and gmv_max_ads_status (UNOCCUPIED can join a GMV Max campaign). Use the item_group_id values for a campaign's product set or a bid recommendation. Single shop only.

get/gmv-max/store-products

Request

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

Query parameters

product_namestring nullable
item_group_idsstring nullable

Comma-separated SPU IDs, at most 10.

gmv_max_eligibilityboolean

Include each product's GMV Max eligibility (gmv_max_ads_status).

sort_field'min_price' | 'historical_sales' nullable
sort_type'ASC' | 'DESC' nullable
pageinteger
page_sizeinteger

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