您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
List shop products
Developer docs / Products and showcase

List shop products

Queries shop products with pagination, keyword and sorting options. The supplied source document contains an account-list response instead of product data; the response data structure is pending confirmation.

GET/v1/creator/tiktokshop/product/listByShop
Authentication:
Request header x-api-key: <YOUR_API_KEY>; keep the key on the server and never expose it in client code, logs or shared files.
Success criteria:
HTTP 2xx with code=0; for asynchronous tasks, also query the final status.

Query parameters

FieldTypeRequiredDescription
pageSizeintegerYesItems per page
idintegerYesCreator account ID
pageTokenstringNoPrevious pagination token; omit on first request
titleKeywordstringNoProduct title keyword
sortFieldstringNoSort field, such as PRODUCT_ID or PRICE
sortOrderstringNoSort direction: ASC or DESC

Response and errors

Main response fields come from the published contract; see the JSON Schema. Required refers to the constraint in the containing object.

FieldTypeRequiredDescription
codeintegerYes—
messagestringYes—
dataobjectYesThe shop product response structure is pending confirmation. Use the actual response and do not infer unconfirmed fields.
timestampintegerYes—

Fix parameter, permission or authorization errors before retrying. If task creation times out, query existing tasks first and do not submit duplicates after an interrupted poll.

Last updated · 2026-11-16