List TikTok Shop store products
Lists products for a TikTok Shop store URL with cursor-based pagination and an optional region. When `data.page.hasMore` is true, pass `data.page.nextCursor` as the `cursor` query parameter on the next request.
Operation
/v1/tiktok/shop/productsHeaders
API key (`sfk_...`)
Parameters
Public TikTok Shop store URL whose products should be listed.
min 1 chars · max 4096 chars
Pagination cursor from a previous response. Omit to request the first page.
min 1 chars · max 8192 chars
Optional region code for the shop catalog. When omitted, the default catalog region is US.
one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE
Response fields
Endpoint-specific response payload.
Whether the storefront resolved for this request.
one of: found, not_found
Store summary when `lookupStatus` is `found`; null when the store could not be resolved.
Shop seller identifier, when available.
min 1 chars
Shop display name, when available.
min 1 chars
Shop logo image URL, when available.
min 1 chars
Canonical public URL for the shop storefront, when available.
min 1 chars
Region code reported for the storefront, when available.
min 1 chars
Average shop rating, when available.
≥ 0
Approximate units sold for the shop, when available.
≥ 0
Number of shop reviews, when available.
≥ 0
Count of products currently on sale, when available.
≥ 0
Follower count for the shop, when available.
≥ 0
Video count associated with the shop, when available.
≥ 0
Product cards returned for the requested page.
TikTok Shop product identifier.
min 1 chars
Product title text.
min 1 chars
Product description, when available.
Canonical public URL for the product page, when available.
min 1 chars
Primary product image URL, when available.
min 1 chars
Structured image size metadata when the image URL is available.
Image width in pixels, when available.
≥ 0
Image height in pixels, when available.
≥ 0
Primary product image URL.
Reported ship-from location text, when available.
TikTok Shop trust badge label, when available.
Promotional, shipping, and trust labels for the product card.
Label text shown for the product.
TikTok Shop label type code, when available.
Displayed price data.
Currency name or code for displayed prices, when available.
Currency symbol for the listed price, when available.
Current sale price for the product, when available.
Original or list price before discount, when available.
Human-readable discount label, when available.
Human-readable savings line, when available.
Rating and sales metrics for the product.
Approximate units sold, when available.
≥ 0
Number of product reviews, when available.
≥ 0
Average product rating, when available.
≥ 0
Selling shop for the product.
TikTok Shop seller identifier, when available.
Shop display name, when available.
Shop logo image URL, when available.
Pagination state for the current response.
Opaque cursor to pass as `cursor` on the next request when `hasMore` is true; otherwise null.
min 1 chars
Whether another page of products can be requested for this store.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Store listing result. `data.lookupStatus` is `not_found` when the storefront cannot be resolved.
Error codes
Search products
Returns product cards for a TikTok Shop catalog search. Pass a `query` string and optional `page` (1-based) and `region` code. Pagination is page-based; `data.page.hasMore` indicates whether another page can be requested.
Product
Returns detailed catalog data for a TikTok Shop product page URL, including offer and media fields when the page resolves. Response shape may change as the catalog updates.