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
| Field | Type | Required | Description |
|---|---|---|---|
pageSize | integer | Yes | Items per page |
id | integer | Yes | Creator account ID |
pageToken | string | No | Previous pagination token; omit on first request |
titleKeyword | string | No | Product title keyword |
sortField | string | No | Sort field, such as PRODUCT_ID or PRICE |
sortOrder | string | No | Sort 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.
| Field | Type | Required | Description |
|---|---|---|---|
code | integer | Yes | — |
message | string | Yes | — |
data | object | Yes | The shop product response structure is pending confirmation. Use the actual response and do not infer unconfirmed fields. |
timestamp | integer | Yes | — |
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