# List showcase products

- API version: 1.11.0
- Last updated: 2026-11-16
- Server: `https://api.ailingtu.com`
- Web document: [List showcase products](/en/openapi/showcase-products)
- Full schema: [JSON Schema](/en/openapi/operations/listTikTokShowcaseProducts.json)
- Discovery: [Operation index](/en/openapi/operations/index.json)

## GET /v1/creator/tiktokshop/product/listByShowcase

Operation ID: `listTikTokShowcaseProducts`

List products in a creator showcase. Use SHOWCASE as the product source when creating a post.

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 parameters

| Field | Location | Type | Required | Description |
|---|---|---|---|---|
| `id` | query | integer | Yes | Creator account id |
| `origin` | query | LIVE \| SHOWCASE | Yes | Product source: LIVE or SHOWCASE |
| `pageSize` | query | integer | Yes | Items per page |
| `pageToken` | query | string | No | Pagination token from the previous response |

### Success response

```json
{
  "code": 0,
  "data": {
    "products": [
      {
        "id": "1732280564607717841",
        "title": "Summer Vibes Cord",
        "price": {
          "amount": "19.99",
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://cdn.example.com/product.jpg",
            "width": 800,
            "height": 800
          }
        ]
      }
    ],
    "nextPageToken": "",
    "totalCount": 1
  },
  "message": "success"
}
```

### Response fields

Main levels are listed below. The endpoint JSON Schema is authoritative for the full structure, unions and validation rules; Required refers to the containing object.

| Field | Type | Required | Description |
|---|---|---|---|
| `code` | integer | Yes | Fixed value: 0 |
| `message` | string | No | — |
| `data` | object | Yes | — |
| `data.products` | object[] | Yes | — |
| `data.products[].id` | string | Yes | — |
| `data.products[].title` | string | Yes | — |
| `data.products[].price` | union | No | — |
| `data.products[].images` | object[] | No | — |
| `data.products[].images[].url` | string | Yes | — |
| `data.products[].images[].width` | integer | No | — |
| `data.products[].images[].height` | integer | No | — |
| `data.products[].shop` | object | No | — |
| `data.products[].shop.name` | string | Yes | — |
| `data.products[].addition` | null | No | — |
| `data.products[].mainImages` | object[] | No | — |
| `data.products[].mainImages[].width` | integer \| null | Yes | — |
| `data.products[].mainImages[].height` | integer \| null | Yes | — |
| `data.products[].mainImages[].url` | string | Yes | — |
| `data.products[].status` | object | No | — |
| `data.products[].status.inventoryStatus` | string | Yes | — |
| `data.products[].status.reviewStatus` | string | Yes | — |
| `data.products[].status.isHidden` | boolean | Yes | — |
| `data.products[].status.addedStatus` | string | Yes | — |
| `data.products[].source` | string | No | — |
| `data.products[].detailLink` | null | No | — |
| `data.products[].thirdPartyLink` | null | No | — |
| `data.products[].saleRegions` | array \| null | No | — |
| `data.products[].commission` | object | No | — |
| `data.products[].commission.rate` | integer | Yes | — |
| `data.products[].commission.rewardRate` | null | Yes | — |
| `data.products[].collaboration` | object | No | — |
| `data.products[].collaboration.id` | string | Yes | — |
| `data.products[].collaboration.type` | string | Yes | — |
| `data.products[].collaboration.partner` | null | Yes | — |
| `data.nextPageToken` | string | Yes | — |
| `data.totalCount` | integer | Yes | — |

### Integration notes and limits

- This endpoint does not accept titleKeyword. Filter by title on the client when needed.

### Error handling

| HTTP | Description |
|---|---|
| 400 | The request parameters or body are invalid. Fix them and retry. |
| 401 | The API key is missing or invalid. Check x-api-key. |
| 403 | The API key has no permission to call this endpoint. |
| 429 | Too many requests. Retry with exponential backoff. |
| 500 | The server failed. Retry transient failures with exponential backoff. |

Treat any non-zero business code as a failure. Do not blindly retry parameter, permission or authorization errors. If creating a publishing or generation task times out, query the existing task first instead of creating another one.
