# Tiktok Shop Creators (`lemur/tiktok-shop-creators`) Actor TikTok Shop Creators - Gain powerful insights into TikTok Shop creators β€” their performance (GMV, units sold, engagement), audience, and content trends β€” all in one request. - **URL**: https://apify.com/lemur/tiktok-shop-creators.md - **Developed by:** [Lemur](https://apify.com/lemur) (community) - **Categories:** Social media, Developer tools, E-commerce - **Features:** Limited permissions - **Stats:** 1,057 total users, 205 monthly users, 90.4% runs succeeded, 25 bookmarks - **User rating**: 4.16 out of 5 stars ## Pricing $0.005 / actor run This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### πŸ›οΈ TikTok Shop Creators Analytics Gain powerful insights into TikTok Shop creators β€” their performance, audience, and content trends β€” all in one request. This actor lets you **fetch detailed analytics** for any TikTok Shop creator by simply providing their **username**.\ You’ll receive a comprehensive breakdown of their profile and 30-day performance metrics, refreshed daily. *** ### πŸš€ What This Actor Does The **TikTok Shop Creators** actor collects and structures detailed creator data from TikTok Shop, including: - Verified **creator profile details** (username, nickname, avatar, region, bio) - In-depth **performance analytics** for both **videos** and **lives** - Key **commerce insights** β€” units sold, GMV, commission averages, and promotion scores - **Follower demographics** and engagement data - 30-day performance window with **daily refreshed stats** > **Rate Limit:** To maximise success, try and limit the number of requests you make per second to betwee 1 and 10. Any more and the API might choke. I'm working on scaling this up better. *** ### πŸŽ‰ Big News: Prices Are Coming Down! πŸŽ‰ We're making the actor more affordable! Starting in **November** *(exact date to be announced)*, we're rolling out a pricing update with exciting discounts across all of Apify's standard tiers. #### πŸ’Έ Your New Discounts Enjoy more savings on your subscription: | πŸ† Plan | 🎁 Discount | | --------- | ----------: | | πŸ₯‰ Bronze | **5% OFF** | | πŸ₯ˆ Silver | **10% OFF** | | πŸ₯‡ Gold | **20% OFF** | The higher your tier, the bigger your savings! πŸš€ #### 🏒 Enterprise Customers: Let's Talk! Looking for enterprise pricing? In collaboration with Apify, we now offer **custom discounts for customers willing to commit to a monthly subscription.** Get in touch with Apify to discuss further. #### πŸ“© Have Questions? Need clarification about the upcoming pricing changes? We're happy to help! Reach out to me at `lemurxn@gmail.com`. ✨ More value. Lower prices. Same great service. *** ### 🌍 Region Support - βœ… **United States** β€” fully supported - 🌎 **Other regions coming soon** (UK, TH, SEA, EU, BR) *** ### πŸ’‘ Use Cases β€” What You Can Build This actor is perfect for developers, marketers, and analysts looking to: - πŸ•΅οΈ **Find high-performing creators** for influencer or affiliate partnerships - πŸ“Š **Track creator performance** over time for brand collaborations - πŸ’° **Analyze sales impact** across creators and campaigns - πŸ“ˆ **Build dashboards or databases** for TikTok Shop analytics - πŸ” **Discover emerging creators** based on engagement or sales potential - 🧠 **Train AI models** to predict creator performance or match brands to influencers If you work in **influencer marketing**, **e-commerce**, or **social commerce intelligence**, this actor is a must-have. *** ### 🧩 Related Actors - [TikTok Shop Product Scraper](https://apify.com/lemur/tiktok-shop-products) - Scrape TikTok Shop products - [TikTok Affiliate Products](https://apify.com/lemur/tiktok-shop-affiliate-products) - A "lite" version of the above actor (US Only. More regions coming soon ✨) *** ### 🧾 Example Output For each TikTok Shop creator, you’ll receive structured JSON data like: ```json { "username": "creatorname", "nickname": "Creator Display Name", "avatar": "https://p16-sign-va.tiktokcdn.com/avatar.jpg", "region": "US", "bio": "Lover of skincare & lifestyle content πŸ’•", "stats": { "categories": ["123", "456"], "categoryList": [{ "id": "123", "name": "Home Supplies" }], "followers": { "total": 456780, "topDemographics": { "age": [ { "key": "18-24", "value": 40 }, { "key": "25-34", "value": 29 } ], "gender": [ { "key": "Male", "value": 38 }, { "key": "Female", "value": 72 } ], "location": [ { "state": "CA", "value": 38 }, { "state": "NY", "value": 26 } ] } }, "topBrands": ["arwd", "kweu"], "totalBrandCollaborations": 9, "promotedProducts": 24, "unitsSold": 480, "gpm": { "currency": "USD", "amount": 10.55, "range": "2-15", "videoGpm": { "amount": "18.99", "range": "12.5-29.65" }, "liveGpm": { "amount": "99", "range": "56-198" } }, "gmvRange": "$5K-$25K", "gmv": { "currency": "USD", "total": 43879, "video": 39500, "live": 4379 }, "gmvDistribution": { "category": [ { "id": "1234", "value": 26 }, { "id": "6789", "value": 24 } ], "content": [ { "type": "video", "value": 72 }, { "type": "live", "value": 10 }, { "type": "showcase", "value": 18 } ] }, "avgViews": { "video": 35800, "live": 1500 }, "avgLikes": { "video": 1700, "live": 290 }, "avgComments": { "video": 400, "live": 900 }, "avgShares": { "video": 98 }, "engagementRate": { "video": 10.9, "live": 12.3 }, "contentFrequency": { "video": 46, "live": 10 }, "avgCommission": { "range": "10-20", "value": 15 }, "rating": "4.5", "promotionPerformanceScore": 87, "postRate": 12.85 } } ``` *** ### πŸ“‹ Data Fields Reference | **Property** | **Description** | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `username` | The TikTok Shop creator’s handle. | | `nickname` | The creator’s public display name. | | `avatar` | URL to the creator’s profile picture. | | `region` | Creator’s primary TikTok Shop region (currently only `US`). | | `bio` | Profile description as shown on TikTok. | | **`stats.categories`** | Category ids associated with products the creator has created posts for. | | **`stats.followers.total`** | Total followers the creator has. | | **`stats.followers.topDemographics.age`** | Age group breakdown of followers (percentage). | | **`stats.followers.topDemographics.gender`** | Gender distribution of followers (percentage). | | **`stats.followers.topDemographics.location`** | Distribution of followers by location (percentage). Uses the [two-letter state abbreviation](https://www.faa.gov/air_traffic/publications/atpubs/cnt_html/appendix_a.html). | | **`stats.topBrands`** | A list of ids for the top brands which the creator has collaborated with. | | **`stats.totalBrandCollaborations`** | Total number of brands that the creator has collaborated with. | | **`stats.promotedProducts`** | Total number of products that the creator has promoted. | | **`stats.unitsSold`** | Total products sold through TikTok Shop in the last 30 days. | | **`stats.gpm`** | GMV per mile (GPM) data for the creator. The Gross Merchandise Value generated per 1,000 video views. | | **`stats.gmv.currency`** | Gross Merchandise Value generated in the last 30 days (USD). | | **`stats.gmv.total`** | Gross Merchandise Value (GMV) generated in the last 30 days (USD). | | **`stats.gmv.video`** | GMV attributed to videos over the past 30 days (USD). | | **`stats.gmv.live`** | GMV attributed to lives over the past 30 days (USD). | | **`stats.gmvDistribution.category`** | A list of categories and their attributed GMV in percentage for the creator. | | **`stats.gmvDistribution.content`** | GMV distribution by creator content - video, live and product showcase. | | **`stats.avgViews.video`** | Average number of views per video over the last 30 days. | | **`stats.avgViews.live`** | Average number of views per live session. | | **`stats.avgLikes.video`** | Average number of likes per video. | | **`stats.avgLikes.live`** | Average number of likes per live stream. | | **`stats.avgComments.video`** | Average number of comments per video. | | **`stats.avgComments.live`** | Average number of comments per live session. | | **`stats.avgShares.video`** | Average number of shares per video. | | **`stats.engagementRate.video`** | The number of post engagements (likes, shares, and comments) divided by the total video views averaged across the videos in the last 30 days (percentage). | | **`stats.engagementRate.live`** | E-commerce live stream engagement rate (percentage). | | **`stats.contentFrequency.video`** | The number of e-commerce video posts associated with the creator. | | **`stats.contentFrequency.live`** | The number of e-commerce livestreams associated with the creator. | | **`stats.avgCommission.range`** | Average commission range for the creator. | | **`stats.avgCommission.value`** | Average affiliate commission percentage across promoted products. | | **`stats.rating`** | Creator rating from brands that have worked with them before. | | **`stats.promotionPerformanceScore`** | The score reflects the quality of a creator’s shoppable content and product selection over the past 90 days. Higher scores suggest a better shopping experience with fewer refunds or negative reviews. | | **`stats.postRate`** | Likelihood in percentage, that the creator will make a video or live after receiving a sample from a brand. | *** ### πŸ”„ Data Freshness All statistics represent **rolling 30-day performance** and are **refreshed daily** to ensure up-to-date analytics. *** ### 🧠 Why Choose This Actor Unlike generic TikTok scrapers, **TikTok Shop Creators** focuses on the *commerce side* of TikTok β€” giving you **actionable insights** that drive **sales**, **partnerships**, and **campaign ROI**. It’s perfect for: - Brand owners and agencies scouting creators - Influencer platforms enriching their data - Market researchers analyzing trends in social commerce *** ### βš™οΈ How to Use 1. Provide a TikTok Shop creator username as input. 2. Run the actor. 3. Get structured JSON output with full creator analytics. You can run this actor directly on Apify or integrate it into your workflows via the Apify API. *** ### πŸ’‘ Please note If the creator has not given permission for precise data sharing, some stat properties will not be present and you might get `null` values. *** ### πŸ’Έ Start Exploring TikTok Shop Creators Unlock the data behind TikTok’s fastest-growing creators today. *Accurate. Structured. Actionable.* ### πŸ“© Contact For any queries, requests for more data or consultation send an email to `lemurxn@gmail.com` ✌️ # Actor input Schema ## `username` (type: `string`): Enter creator username or handle ## `region` (type: `string`): ISO 3166-2 country code ## Actor input object example ```json { "username": "dealswithty", "region": "us" } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "username": "dealswithty", "region": "us" }; // Run the Actor and wait for it to finish const run = await client.actor("lemur/tiktok-shop-creators").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "username": "dealswithty", "region": "us", } # Run the Actor and wait for it to finish run = client.actor("lemur/tiktok-shop-creators").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "username": "dealswithty", "region": "us" }' | apify call lemur/tiktok-shop-creators --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,lemur/tiktok-shop-creators" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/7WXZyKLZvyOPbf5Ih/builds/Fua28kaDUE3pMEQNN/openapi.json