Search TikTok Shop 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.
Operation
/v1/tiktok/shop/products/searchHeaders
API key (`sfk_...`)
Parameters
Search query text for TikTok Shop products.
min 1 chars · max 512 chars
1-based results page number. Omit to request the first page. Pagination is page-based.
≥ 1
Optional country or region code for the product search catalog.
one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE
Response fields
Endpoint-specific response payload.
Search query that was evaluated for this response.
Products 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.
Total matching products reported for the search, when available.
≥ 0
Pagination state for the current response.
1-based page number for this response.
≥ 1
Next page number to request when more results are available; otherwise null.
≥ 1
Whether more product pages are likely available for this search.
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
Product search results for the requested page.
Error codes
Live stream
Looks up a TikTok handle and returns live stream details when broadcasting, with profile fields for lookup context.
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.