tiktok/creator/video-list-analytics

Get Creator Video List Analytics

Purpose:

• Retrieve a list of videos published by a TikTok Shop creator account within a specified time range, along with detailed performance metrics.
• Supports pagination to fetch multiple pages of video records within the given time range.

Response Fields:

• segments (List of segmented data):
  • time_selector: Time range settings (start/end timestamps, timezone, locale)
  • filter.creator_id: Creator account ID
  • list_control:
    • rules: List sorting rules (typically by publish time descending)
    • next_pagination: Pagination information (has more pages, current page, total pages, total records)
  • timed_lists: List of videos for each time range, including:
    • video_meta:
      • item_id: Video Item ID
      • name: Video title
      • publish_time: Video publish time (Unix timestamp)
      • duration: Video duration (seconds)
      • video_play_info: Video play resources (cover image, playback URL, etc.)
    • new_follower_cnt: Number of new followers during the video's period
    • vv_cnt: Video views count
    • ctr: Click Through Rate for associated products
    • gmv.amount: Gross Merchandise Value generated by the video
    • item_sold_cnt: Number of items sold due to the video
    • direct_gmv.amount: Direct GMV from the video
    • completion_rate: Video completion rate

Notes:

• This API is only available for TikTok Shop creator accounts.
• Data is grouped by natural day or week, and each video's stats represent the corresponding period.

Parameters:

• cookie: User Cookie string for authentication
• start_date: Query start date, formatted as 'MM-DD-YYYY', e.g., '04-01-2025'
• page: Page number, default is the first page 0
• rules: List sorting rules, default is by publish time. Available options:
  • "VIDEO_LIST_PUBLISH_TIME": Sort by video publish time
  • "VIDEO_LIST_GMV": Sort by gross merchandise value (GMV)
  • "VIDEO_LIST_DIRECT_GMV": Sort by direct GMV
  • "VIDEO_LIST_VV_CNT": Sort by video view count
  • "VIDEO_LIST_ITEM_SOLD_CNT": Sort by number of items sold
  • "VIDEO_LIST_CTR": Sort by click-through rate
  • "VIDEO_LIST_COMPLETION_RATE": Sort by video completion rate
  • "VIDEO_LIST_LIKE_CNT": Sort by number of likes
  • "VIDEO_LIST_NEW_FOLLOWER_CNT": Sort by number of new followers
• proxy: Optional HTTP proxy address, can be omitted if not used
  • Example format: http://username:password@host:port

Return:

• Detailed video list and performance analysis for the creator account

[Example]

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

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