TikTok Shop Creators Actor

This actor fetches detailed analytics for TikTok Shop creators. Provide a username, and it returns structured data on their profile, performance, and audience demographics for the last 30 days.

Overview

The actor scrapes and structures data from TikTok Shop. It currently supports US-based creators only, with plans to add more regions. Data is refreshed daily.

Key Features

• Profile Data: Fetches the creator's username, nickname, avatar URL, region, and bio.
• Performance Analytics: Provides 30-day metrics for videos and live streams, including average views, likes, comments, and shares.
• Commerce Insights: Returns units sold, Gross Merchandise Value (GMV), average commission, and a promotion performance score.
• Audience Demographics: Includes total follower count with a breakdown by top age groups and gender.
• Structured Output: Returns all data in a consistent JSON format.

How to Use

Run the actor with a TikTok Shop creator's username as the input. The main input field is username.

Rate Limit Note: To ensure reliable operation, limit requests to between 1 and 10 per second.

Input/Output

Input:
The primary required input is the creator's username.

Output:
The actor returns a JSON object containing the creator's profile and a stats object with their 30-day performance data.

{
  "username": "creatorname",
  "nickname": "Creator Display Name",
  "avatar": "https://example.com/avatar.jpg",
  "region": "US",
  "bio": "Profile bio text.",
  "stats": {
    "followers": {
      "total": 456780,
      "topDemographics": {
        "age": [{"key": "18-24", "value": "40"}],
        "gender": [{"key": "Female", "value": "72"}]
      }
    },
    "unitsSold": 480,
    "gmv": {
      "currency": "USD",
      "total": 43879,
      "video": 39500,
      "live": 4379
    },
    "avgViews": { "video": 35800, "live": 1500 },
    "avgLikes": { "video": 1700, "live": 290 },
    "engagementRate": { "video": 10.9, "live": 12.3 }
  }
}

Key Data Fields:
* username, nickname, avatar, region, bio
* stats.followers.total & stats.followers.topDemographics
* stats.unitsSold
* stats.gmv.total, stats.gmv.video, stats.gmv.live
* stats.avgCommission
* stats.promotionPerformanceScore