# TikTok Shop LIVE Sales: Top Livestreams, Revenue & Products (`memo23/tiktok-shop-live-sales`) Actor

Find the TikTok Shop livestreams that sell the most in 15 markets, or the lives of a creator or a product. Each live has revenue, units sold, viewers, peak viewers, duration, its top 3 products with their sales, and the host. In USD. No login.

- **URL**: https://apify.com/memo23/tiktok-shop-live-sales.md
- **Developed by:** [Muhamed Didovic](https://apify.com/memo23) (community)
- **Categories:** E-commerce, Social media
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 livestreams

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 LIVE Sales: Top Livestreams, Revenue & Products

**See which TikTok Shop livestreams actually sell.** Rank the lives of any of 15 markets by units sold or viewers, or pull every live of a creator, a brand's own account or a product.

Every livestream row carries its revenue and units sold, total and peak viewers, when it started and how long it ran, the three products that sold best in it with their own sales, the revenue split by category, and the host with their followers. Amounts are in US dollars in every market.

### Why Use This Scraper?

- **Sales per live, not per account.** Revenue, units and revenue per 1,000 views for each livestream, so you see which lives worked and which did not.
- **What sold on air.** The top three products of every live with their units and revenue, and a link to each.
- **Any window.** Lives that started in the last 24 hours, 7, 30 or 90 days, or any time, including lives still on air.
- **Shops and creators apart.** One field says whether the brand hosted the live or an affiliate creator did, with a filter for each.
- **15 markets, one currency.** United States, United Kingdom, Germany, France, Italy, Spain, Brazil, Japan, Mexico, Indonesia, Thailand, Vietnam, Philippines, Malaysia and Singapore, all in USD.
- **Pay for livestreams, not attempts.** $2.00 per 1,000 livestreams on the Bronze plan (down to $1.60 on Gold and up) plus $0.005 when the run starts. Lives outside your filters are not charged.

### Overview

This actor is for people who sell, recruit or compete on TikTok Shop LIVE: brands planning their own lives, agencies and affiliate managers looking for hosts who sell, and analysts tracking live commerce.

You choose a market and a time window. With no other input, you get that market's best-selling livestreams. A creator or a product each keeps its own ranking, and a livestream found twice is delivered once.

The dataset exports as JSON, CSV, Excel or through the API. A `RUN_SUMMARY` record in the run's key-value store lists what each input delivered.

### Supported Inputs

| What you give | What you get |
|---|---|
| Nothing (both lists empty) | The market's top livestreams in your time window |
| A creator: `@based`, `based` or `https://www.tiktok.com/@based` | That account's livestreams in the market. A brand's own TikTok account works the same way |
| A product: `https://www.tiktok.com/view/product/1729619842897449697` or `1729619842897449697` | The livestreams that sold that product, highest revenue first |

### Use Cases

| Who | What they do with it |
|---|---|
| Brands | See how competitors' lives perform, which products they push on air, and how long they run |
| Affiliate managers | Find creators whose lives sell, with their followers and how often they go live |
| Agencies | Benchmark a client's lives against the top of their market and category |
| Analysts | Track live commerce by market, category and time window, in one currency |

### How It Works

![How it works](https://api.apify.com/v2/key-value-stores/feUcZZbzjrpU1YQVP/records/how-it-works-tiktok-shop-live-sales.png)

1. **Choose a market** and a time window, and if you want, creators or products.
2. **Rank** the livestreams by units sold, viewers, peak viewers or newest first. Lives found through a product are ranked by revenue.
3. **Filter** by host type, on air or ended, and minimum revenue, units, viewers or length.
4. **Export** the dataset as JSON, CSV or Excel, or read it through the API.

### Input Configuration

| Field | Default | What it does |
|---|---|---|
| `market` | `US` | The TikTok Shop country, e.g. `US`, `GB`, `DE`, `ID` |
| `period` | `last7Days` | `last24Hours`, `last7Days`, `last30Days`, `last90Days` or `any` |
| `sortBy` | `unitsSold` | `unitsSold`, `viewers`, `peakViewers` or `newest` |
| `creators` | empty | Usernames or profile links |
| `products` | empty | Product links or ids |
| `maxLives` | `50` | Livestreams per input, up to 1,000 |
| `liveType` | `any` | `shop` (the brand hosts) or `creator` (an affiliate hosts) |
| `liveStatus` | `any` | `ended` or `live` (on air now) |
| `minRevenue`, `minUnitsSold`, `minViewers`, `minDurationMinutes` | none | Minimums a livestream must reach |
| `includeNonSelling` | `false` | Also return lives that sold nothing |

#### Example inputs

The best-selling lives in the UK this week:

```json
{ "market": "GB", "period": "last7Days", "sortBy": "unitsSold", "maxLives": 100 }
```

Creator-hosted lives in the US that made at least $10,000 in the last 30 days:

```json
{ "market": "US", "period": "last30Days", "liveType": "creator", "minRevenue": 10000 }
```

A brand's own lives:

```json
{ "market": "US", "creators": ["@based"], "period": "last90Days" }
```

### Output Overview

One row per livestream: the live, its sales, its audience, its top products and its host. Lives still on air carry their running totals, no end time and a `liveUrl` that opens the live.

### Output Samples

On 18 Nov 2026 the best-selling US live of the last 30 days on the BASED account ran almost five days and sold 26,953 units:

```json
{
  "liveId": "7704767945901132575",
  "title": "DEALS FOR YOU - Live Now!",
  "market": "US",
  "rank": 1,
  "source": "creator",
  "sourceInput": "@based",
  "liveType": "shop",
  "status": "ended",
  "startedAt": "2026-11-05T19:16:27.000Z",
  "endedAt": "2026-11-10T12:16:21.000Z",
  "durationMinutes": 6780,
  "revenue": 2416687.95,
  "unitsSold": 26953,
  "avgPrice": 74.41,
  "revenuePerThousandViews": 919.15,
  "viewers": 2629276,
  "peakViewers": 968,
  "productCount": 59,
  "sellingProductCount": 57,
  "followersGained": 13926,
  "mainCategory": "Beauty & Personal Care",
  "topProducts": [
    {
      "productId": "1732307769700553014",
      "name": "BASED Deluxe Straight/Wavy Hair Kit | Shampoo, Conditioner, Texture Powder, ...",
      "unitsSold": 2906,
      "revenue": 604448,
      "productUrl": "https://www.tiktok.com/view/product/1732307769700553014"
    }
  ],
  "hostUsername": "based",
  "hostName": "BASED",
  "hostUrl": "https://www.tiktok.com/@based",
  "hostFollowers": 4603333,
  "hostLives30d": 8,
  "hostSellingLives30d": 8
}
```

### Key Output Fields

| Group | Fields |
|---|---|
| The live | `liveId`, `title`, `market`, `rank`, `source`, `sourceInput`, `liveType`, `status`, `startedAt`, `endedAt`, `durationMinutes`, `liveUrl` |
| Sales | `revenue`, `unitsSold`, `avgPrice`, `revenuePerThousandViews`, `productCount`, `sellingProductCount` |
| Audience | `viewers`, `peakViewers`, `followersGained` |
| Products | `topProducts` (id, name, units, revenue, link), `mainCategory`, `categoryRevenue` (top 5 categories by revenue) |
| Host | `hostUsername`, `hostName`, `hostUserId`, `hostUrl`, `hostCategory`, `hostFollowers`, `hostLikes`, `hostVideos`, `hostLives30d`, `hostSellingLives30d` |

### FAQ

**Where do the revenue figures come from?**
They are the sales estimates live-commerce dashboards show for a livestream, in US dollars. Compare `revenue / unitsSold` with `avgPrice` if a live looks off.

**Why does a live have high revenue but few viewers?**
It happens mostly with shop lives that run for many hours over a large catalogue. The figures are estimates, so treat a large gap between revenue and viewers with care, and use `minViewers` if you only want lives with a real audience.

**Can I get a shop's lives?**
Put the shop's own TikTok account under `creators`. Lives hosted by affiliates for that shop show up through `products`: give the shop's best sellers.

**Does a product input respect the market?**
A product id is the same everywhere, so its lives come from whatever market sold it. `market` sets the ranking and the creators.

**What does the free Apify plan get?**
Up to 20 livestreams from the first input per run. Any paid Apify plan removes the limit.

**How much does it cost?**

| | Free plan | Bronze | Silver | Gold and up |
|---|---|---|---|---|
| Per livestream row | $0.0025 | $0.0020 | $0.0018 | $0.0016 |
| Per run start | $0.005 | $0.005 | $0.005 | $0.005 |

A run of 50 livestreams costs $0.105 on Bronze. Lives outside your filters, duplicates and the run summary are not charged.

### Support

Found a bug or missing a field? Open an issue on the actor's Issues tab with your run link and input.

### Additional Services

Need a daily report of a market's top lives, or a market this actor does not cover? Ask on the Issues tab.

### Explore More Scrapers

- [**TikTok Shop Top Products**](https://apify.com/memo23/tiktok-shop-top-products): products ranked by revenue, with the video, LIVE and shop-window split.
- [**TikTok Shop Sellers**](https://apify.com/memo23/tiktok-shop-sellers): shops ranked by revenue and units.
- [**TikTok Shop Creator Finder**](https://apify.com/memo23/tiktok-shop-creator-finder): affiliate creators with units sold and contact emails.
- [**TikTok Shop Videos**](https://apify.com/memo23/tiktok-shop-videos): revenue and units sold per video.

### 🤖 For AI agents & LLM apps

- **Purpose**: TikTok Shop livestreams ranked by sales or viewers, with revenue, units, viewers, duration, top products and host, in 15 markets.
- **Minimal input**: `{ "market": "US" }` returns the top 50 selling lives of the last 7 days.
- **Inputs**: `market`, `period`, `sortBy`, `creators[]`, `products[]`, `maxLives`, `liveType`, `liveStatus`, `minRevenue`, `minUnitsSold`, `minViewers`, `minDurationMinutes`, `includeNonSelling`.
- **Output fields**: `liveId`, `title`, `market`, `rank`, `liveType`, `status`, `startedAt`, `endedAt`, `durationMinutes`, `revenue`, `unitsSold`, `avgPrice`, `viewers`, `peakViewers`, `productCount`, `topProducts[]`, `mainCategory`, `hostUsername`, `hostFollowers`, `hostUrl`.
- **Billing**: $0.002 per livestream on Bronze, $0.005 when the run starts. Filtered-out lives are not charged.
- **Behaviour**: empty lists rank the whole `market`. Product inputs rank by revenue. A live found twice is delivered once. A run that cannot read the lives ends FAILED with the reason.

### ⚠️ Disclaimer

This actor returns publicly available information about TikTok Shop livestreams and the accounts that host them, with sales figures that are estimates. It does not log in or read private data. Host data can be personal data: you are responsible for having a lawful basis to process it under the laws that apply to you (for example the GDPR or CCPA) and for following TikTok's Terms of Service. This actor is not affiliated with or endorsed by TikTok.

### SEO Keywords

tiktok shop live, tiktok live sales, tiktok shop livestream data, tiktok live commerce, tiktok shop live gmv, top tiktok shop lives, tiktok live shopping analytics, tiktok shop live revenue, tiktok live selling, tiktok shop live hosts, tiktok live creators sales, tiktok shop live products, best selling tiktok lives, tiktok shop live ranking, tiktok live stream scraper, tiktok shop us live, tiktok shop uk live, tiktok live commerce data, tiktok shop live viewers, tiktok shop affiliate live

# Actor input Schema

## `market` (type: `string`):

Which TikTok Shop country to rank, for example US or GB. Default US. Creators are looked up in this market too. Money columns are in US dollars in every market.

## `period` (type: `string`):

Only livestreams that started in this window. Default: the last 7 days.

## `sortBy` (type: `string`):

Highest first: units sold in the live, total viewers, peak viewers at one moment, or the newest first. Lives found through a product are always ranked by revenue.

## `creators` (type: `array`):

TikTok accounts whose lives you want, one per line: a username, @username or profile link, for example <b>@based</b>. A shop's own TikTok account works here too. Leave this and Products empty to rank the whole market.

## `products` (type: `array`):

TikTok Shop products, one per line: a product link or the numeric product id. You get the livestreams that sold that product, highest revenue first, in any market.

## `maxLives` (type: `integer`):

Upper limit for the market, each creator and each product. The same livestream found twice is delivered once. Default 50.

## `liveType` (type: `string`):

Shop lives are hosted by the brand's own account; creator lives by an affiliate creator.

## `liveStatus` (type: `string`):

A live that is still on air shows its running totals and has no end time yet.

## `minRevenue` (type: `integer`):

Leave out livestreams that sold less than this, in US dollars.

## `minUnitsSold` (type: `integer`):

Leave out livestreams that sold fewer units.

## `minViewers` (type: `integer`):

Leave out livestreams with fewer total viewers.

## `minDurationMinutes` (type: `integer`):

Leave out ended livestreams shorter than this.

## `includeNonSelling` (type: `boolean`):

Off by default: only livestreams with at least one sale are returned.

## Actor input object example

```json
{
  "market": "US",
  "period": "last7Days",
  "sortBy": "unitsSold",
  "maxLives": 50,
  "liveType": "any",
  "liveStatus": "any",
  "includeNonSelling": false
}
```

# Actor output Schema

## `results` (type: `string`):

TikTok Shop livestreams with revenue, units sold, viewers, duration, top products and host, in 15 markets.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("memo23/tiktok-shop-live-sales").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("memo23/tiktok-shop-live-sales").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 '{}' |
apify call memo23/tiktok-shop-live-sales --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,memo23/tiktok-shop-live-sales"
        }
    }
}
```

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 <APIFY_API_TOKEN>` 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/vP0eKg50AlKdQoCPd/builds/lWQ8HAiG4ICSfEKvZ/openapi.json
