tiktok/creator/video-to-product-stats

Get Video-Product Association Statistics

Purpose:

• Retrieve detailed promotional statistics between a specific TikTok video and a specific product.
• Supports analyzing metrics such as product views, clicks, sales, order counts, product revenue, and direct revenue.
• The data is segmented by time intervals (daily/weekly/monthly) to observe trends over time.

Notes:

• Requires both item_id (video ID) and product_id (product ID).
• The time range is based on the calendar month of the specified start_date.

Return Description:

• segments:
  • time_selector: Time filtering parameters (period, granularity, start_timestamp, end_timestamp)
  • filter: Query conditions (creator_id, item_id, product_id)
  • timed_stats: Segmented statistics list
    • start_timestamp: Start timestamp
    • end_timestamp: End timestamp
    • stats:
      • item_id: Video ID
      • product_id: Product ID
      • product_revenue.amount_formatted: Total product revenue (formatted string, e.g., "$100.00")
      • product_revenue.amount: Total product revenue (numeric)
      • direct_revenue.amount_formatted: Direct sales revenue (formatted string)
      • product_sales_cnt: Number of products sold
      • product_view_cnt: Number of product views
      • product_click_cnt: Number of product clicks
      • order_cnt: Number of orders created

Example Request Body:

{
  "cookie": "your_cookie",
  "start_date": "04-01-2025",
  "item_id": "7496499484705246507",
  "product_id": "1731050202505515549"
}

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