tiktok/creator/product-analytics-list

Get Creator Product List Analytics

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

[Example]

{
  "cookie": "your_cookie",
  "start_date": "2025-04-01",
  "end_date": "2025-05-01",
  "page": 0
}

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.