# TikTok creator product list analytics

Retrieve the list of products promoted by a TikTok Shop creator account within a specified time range, along with their sales analytics. Takes start date, end date and page, all optional. Served by TikHub.

Purpose:
- Retrieve the list of products promoted by a TikTok Shop creator account within a specified time range, along with their sales analytics.
- Supports sorting by revenue or product publish time and allows pagination.

Response Fields:
- `segments` (List of segmented data):
  - `filter.creator_id`: Creator account ID
  - `list_control`:
    - `rules`: Sorting rules (e.g., by revenue, by product ID)
    - `next_pagination`: Pagination info (has more pages, next page number, total pages, total records)
  - `timed_lists`: List of product statistics within each time range, including:
    - `product`:
      - `id`: Product ID
      - `name`: Product title
      - `cover_image.thumb_url_list`: List of product thumbnail URLs
    - `item_sold_cnt`: Number of items sold
    - `revenue.amount`: Total Gross Merchandise Value (GMV) generated by the product
    - `commission.amount`: Estimated commission income from the product

Notes:
- This API is only available for TikTok Shop creator accounts.
- Data is aggregated by natural month or the customized date range.
- Default sorting is by GMV in descending order.

Parameters:
- cookie: User Cookie string for authentication
- start_date: Start date, formatted as 'YYYY-MM-DD', e.g., '2025-04-01'
- end_date: End date, formatted as 'YYYY-MM-DD', e.g., '2025-05-01'
- page: Page number, default is the first page `0`
- proxy: Optional HTTP proxy address, can be omitted if not used
    - Example format: `http://username:password@host:port`

Return:
- Creator product list and corresponding sales analytics data

- Tool ID: `tikhub/tiktok-creator-get-product-analytics-list`
- Name in the catalog: Tiktok, Get Creator Product List Analytics
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [TikTok Shop products](/tools/tiktok/shop.md)
- Price: $0.001 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.001
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.001; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "title": "Start Date",
      "description": "开始日期，如 '2025-04-01'/ Start Date, e.g. '2025-04-01'",
      "default": "2025-04-01"
    },
    "end_date": {
      "type": "string",
      "title": "End Date",
      "description": "结束日期，如 '2025-05-01'/ End Date, e.g. '2025-05-01'",
      "default": "2025-05-01"
    },
    "page": {
      "type": "integer",
      "title": "Page",
      "description": "页码/Page Number",
      "default": 0
    }
  },
  "additionalProperties": false,
  "required": []
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/tiktok-creator-get-product-analytics-list",
  "input": {
    "start_date": "2025-04-01",
    "end_date": "2025-05-01",
    "page": 0
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/TikTok-Creator-API/get_product_analytics_list_api_v1_tiktok_creator_get_product_analytics_list_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/tiktok-creator-get-product-analytics-list) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/tiktok-creator-get-product-analytics-list) · [Agent index](/llms.txt)