List products

Product performance metrics aggregated over a date range. Defaults to the last 7 days if no dates are specified. Data is typically 2-3 days behind the current date. Each product also carries its TikTok Seller Center per-product metrics as sc_* fields: all-channel GMV with its per-channel breakdown (affiliate, seller video, seller live, product card, shop tab), plus orders, units sold, customers, impressions, clicks, CTR, conversion, AOV, GMV per 1,000 impressions, add-to-cart, and refunds. The sc_* fields are null for products not yet on the Seller Center sync.

post/products/list

Request body

pageinteger

page_sizeinteger

sort_by'gmv' | 'units_sold' | 'video_count' | 'sample_count' | 'est_commission' nullable

sort_dir'asc' | 'desc'

start_datestring date nullable

end_datestring date nullable

product_namestring nullable

Response

Successful Response

currencystring required

{"stackTrail":"components:schemas:ProductsListPaginatedResponse:properties:pagination","oasType":"schema","type":"unknown","title":"Pagination"}

shops_queriedstring[] nullable

Shop names included when querying multiple shops (x-shop-id: all or comma-separated).

Changes

No recorded changes to this endpoint across all 1 revision of this API.