Developer docs / Products and showcase
Creator TTS - Remove showcase products
Remove TikTok Shop products from an authorized creator showcase by product IDs.
POST
/v1/creator/tiktokshop/product/removeFromShowcase- 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.
Request body fields
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Creator account id |
productIds | string[] | Yes | Product IDs to remove; 1–200 entries |
Required scope: creator.showcase.write.
A request can remove up to 200 product IDs.
data is null on success; this endpoint has no per-product result.
Platform error 16015001 becomes “商品已不在橱窗中,请刷新列表后重试” (the product is no longer in the showcase; refresh and retry).
Platform error 16015027 is returned as-is and can be retried.
An expired creator authorization returns “授权过期,请重新授权” (authorization expired, reauthorize) and marks the account invalid; a missing scope returns “该达人未授予此功能需要的权限” (the creator has not granted the required permission) without invalidating the account.
Request body
{
"id": 12345,
"productIds": [
"12390753231",
"7102893481290"
]
}Success response
{
"code": 0,
"message": "success",
"data": null,
"timestamp": 1790640000000
}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 | Business status code. 0 indicates success. |
message | string | Yes | — |
data | null | Yes | This endpoint returns no business data. |
timestamp | integer | Yes | Unix timestamp in milliseconds. |
HTTP 400The request parameters or body are invalid. Fix them and retry.HTTP 401The API key is missing or invalid. Check x-api-key.HTTP 403The API key has no permission to call this endpoint.HTTP 429Too many requests. Retry with exponential backoff.HTTP 500The server failed. Retry transient failures with exponential backoff.
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