# TikTok Shop Live Sales Scraper - Top Live Streams (`zen-studio/tiktok-shop-live-sales-scraper`) Actor

Find the TikTok Shop live streams that sell the most in 24 markets: revenue, units sold, views, duration and revenue per hour per stream, plus whether each host is live right now with current viewers and followers. Rank by keyword, category, shop, creator or product.

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

## Pricing

from $2.09 / 1,000 live streams

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

[![Compare TikTok Shop live streams by sales per hour. Compare estimated revenue per hour and see the host’s status at the time of the check.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-live-sales-scraper-readme-hero-6830cfcabb97.png)](https://console.apify.com/actors/2N6OXczLy2hrS1sSK/input)

From **Zen Studio**, creators of the [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper), used by **5,000+ users** to track sales and commission on China's TikTok, and the [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper), used by **9,000+ users**.

### Compare sales per hour across live streams

- Compare sales across streams of different lengths. Each result includes estimated revenue per hour, units sold and duration for the past stream.
- See which hosts are live. Host status is checked during the run. If a host is on air, the result can include the current stream title and viewer count.
- **24 markets.** Choose a country and a reporting period. Sales and revenue figures are estimates.

<a href="https://console.apify.com/actors/2N6OXczLy2hrS1sSK/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-live-sales-scraper-readme-cta-v1-15fa3f84c96e.svg" width="280" height="48" alt="Try 20 top live streams" /></a>

#### Compare seven days of UK live streams

```json
{
  "country": "GB",
  "period": "last7Day",
  "currency": "USD",
  "maxResultsPerSource": 20,
  "addLiveStatus": true
}
```

[Open the actor input](https://console.apify.com/actors/2N6OXczLy2hrS1sSK/input), paste the example in JSON view and press **Start**. Live status is on by default and included in the stream charge. Compare revenue per hour in the export.

#### Copy to your AI assistant

```text
Help me use zen-studio/tiktok-shop-live-sales-scraper on Apify. Read https://apify.com/zen-studio/tiktok-shop-live-sales-scraper.md for documentation, input schema, pricing and limits. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. Each keyword, category, shop, creator or product is its own ranked list of live streams capped by maxResultsPerSource; with no input the run returns the overall top live streams of the country, and a live stream found by several inputs is delivered and charged once. Keywords found live streams by the host's username or display name in our tests, not by the stream title; to rank the live streams of a product type, use categories. addLiveStatus is on by default and included in the live stream price: it reports whether each host is live at the time of the run, with current viewers and followers. addAnalytics is off by default and adds its own charge per live stream, about ten times the base row price, so switch it on only when I need products shown or top product IDs. Revenue and units sold are estimates for comparing live streams, not accounting figures; compare durations, views and revenue per hour within one run. The per-input run summary is in the OUTPUT record of the run's key-value store. On the Apify Free plan the actor is a preview: 5 runs of up to 100 live streams, and addAnalytics applies to the first 10 live streams of each run. To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

### What does the TikTok Shop Live Sales Scraper do?

It ranks TikTok Shop live streams by sales for the market and time window you choose, and returns one row per live stream with its host. Use it to find the live streams that sell the most in a market or category, to follow the live streams of one host, brand or product, to scout hosts for live selling, or to see which of the top sellers are live right now.

Each list is the top of TikTok Shop by your chosen order: revenue, views, average selling price, newest first or duration. Products, shops, shoppable videos and creators each have their own actor (see the end of this page).

### What you get beyond a plain live stream ranking

| | |
|---|---|
| **Live status of every host, now** | Whether the host is live at the time of your run, viewers and entries of the current stream, its title and start time, the host's followers, display name and verified badge. On by default, included in the row price |
| **Revenue per hour** | Revenue divided by the stream's duration, so a 40-minute stream and a 12-hour marathon compare fairly |
| **Units sold per live stream** | Estimated units next to revenue and the average selling price |
| **Five ways in** | Keywords (matched against host names in our tests), categories, shops, creators (TikTok username, profile link or ID) and products |
| **24 markets** | US, UK, Germany, France, Italy, Spain, Poland, Netherlands, Belgium, Czechia, Austria, Greece, Portugal, Hungary, Ireland, Indonesia, Thailand, Vietnam, Philippines, Malaysia, Singapore, Japan, Mexico, Brazil |
| **Any currency, any window** | US dollars, each market's own currency or one of 16 currencies; yesterday, 7 or 30 days, a past month or a custom range of up to 31 days |
| **A summary per input** | The run's OUTPUT record lists how many live streams each input delivered and what to change for an input that found nothing |

### How to find the top-selling TikTok Shop live streams

1. Pick a **🌍 Country** and a **📅 Period**. With nothing else set, you get the overall top live streams of that market.
2. Optionally add **🔍 Keywords**, **🗂️ Categories**, **🏪 Shops**, **👤 Creators** or **📦 Products**. Each entry is its own ranked list.
3. Set **🔢 Max results per source** (live streams per list) and, if you like, a sort order and a host follower range.
4. Press **Start** and export JSON, CSV, Excel or HTML.

#### Input options

| Parameter | Type | Default | Meaning |
|---|---|---|---|
| `keywords` | list | empty | Each keyword is its own ranked list of live streams; in our tests it matched the host's username or display name, for example `deals` |
| `categories` | list | empty | TikTok Shop category names or IDs: `Beauty & Personal Care`, `Kitchen Appliances`, `601450` |
| `shops` | list | empty | Store links, shop IDs or exact shop names: the live streams of each shop |
| `creators` | list | empty | TikTok usernames (`@name`), profile links or numeric IDs: the live streams of each host |
| `productIds` | list | empty | TikTok Shop product links or IDs: the live streams selling each product |
| `country` | select | `US` | One of 24 TikTok Shop markets |
| `period` | select | `last30Day` | `lastDay` (yesterday), `last7Day` or `last30Day` |
| `month` | text | empty | A past calendar month such as `2026-10`; overrides `period` |
| `dateFrom`, `dateTo` | date | empty | Your own window of up to 31 days, ending yesterday or earlier; overrides `month` and `period` |
| `maxResultsPerSource` | number | `100` | Live streams per list, 1 to 10,000 |
| `currency` | select | `USD` | `USD`, `local` (the market's own currency) or one of 16 currencies |
| `sortBy`, `ascending` | select, switch | `revenue`, off | `revenue`, `views`, `price`, `newest` or `duration`; `ascending` puts the lowest first |
| `minFollowers`, `maxFollowers` | numbers | off | Host follower range |
| `addLiveStatus` | switch | on | Live status of each host now, with current viewers and host followers. Included in the row price |
| `addAnalytics` | switch | off | Products shown in the stream, the three best-selling product IDs, viewers and GPM. Extra charge per live stream |

Keyword rows carry `matchStrict`, true when the live title holds every word of the keyword. Because keywords matched host names in our tests, `matchStrict` is often false.

#### More input examples

Every live stream of one brand's TikTok account in the last 30 days, best-selling first:

```json
{
  "creators": [
    "@medicube_official_shop"
  ],
  "country": "US",
  "period": "last30Day",
  "maxResultsPerSource": 20
}
```

The top 50 beauty live streams in the UK last month, in British pounds:

```json
{
  "categories": [
    "Beauty & Personal Care"
  ],
  "country": "GB",
  "month": "2026-10",
  "currency": "local",
  "maxResultsPerSource": 50
}
```

The live streams that sold one product, with the hosts' follower counts:

```json
{
  "productIds": [
    "1732714704454062315"
  ],
  "country": "US",
  "period": "last30Day",
  "maxResultsPerSource": 100
}
```

### What data can you extract from TikTok Shop live streams?

| Group | Fields |
|---|---|
| **Live stream** | `liveId`, `title`, `url`, `startedAt`, `endedAt`, `durationMinutes`, `durationSeconds`, `rank` |
| **Sales in the window** | `revenue`, `unitsSold`, `avgSellingPrice`, `revenuePerHour`, `views` |
| **Host** | `creatorId`, `creatorUsername`, `creatorUrl` |
| **Live status now** | `isLiveNow`, `currentViewers`, `currentLiveEntries`, `currentLiveTitle`, `currentLiveStartedAt`, `creatorFollowers`, `creatorNickname`, `creatorVerified`, `liveStatusCheckedAt` |
| **Analytics (option)** | `viewers`, `gpm`, `productCount`, `topProductIds` |
| **Context** | `type`, `country`, `period`, `periodStart`, `periodEnd`, `currency`, `source`, `sourceInput`, `category`, `matchStrict`, `analytics`, `scrapedAt` |

#### Output example

The first row of the quick-start example above (US, last 7 days, real run on 10 November 2026). This host was not live at the time of the run, so the current-stream fields are empty.

```json
{
  "type": "live",
  "liveId": "7704841742058605325",
  "title": "SBD Deals are here!! Shop NOW❤️",
  "url": "https://www.tiktok.com/@medicube_official_shop/live",
  "creatorId": "7291517492299007018",
  "creatorUsername": "medicube_official_shop",
  "creatorUrl": "https://www.tiktok.com/@medicube_official_shop",
  "revenue": 106552.23,
  "avgSellingPrice": 30.73,
  "unitsSold": 3467,
  "views": 168791,
  "startedAt": "2026-11-06T00:02:00Z",
  "endedAt": "2026-11-06T06:00:22Z",
  "durationSeconds": 21502,
  "durationMinutes": 358.4,
  "revenuePerHour": 17839.64,
  "matchStrict": null,
  "analytics": false,
  "rank": 1,
  "country": "US",
  "period": "last7Day",
  "periodStart": null,
  "periodEnd": null,
  "currency": "USD",
  "source": "top",
  "sourceInput": "top lives US",
  "category": null,
  "scrapedAt": "2026-11-10T13:44:02Z",
  "isLiveNow": false,
  "currentViewers": null,
  "currentLiveEntries": null,
  "currentLiveTitle": null,
  "currentLiveStartedAt": null,
  "creatorFollowers": 754784,
  "creatorNickname": "medicube US Store",
  "creatorVerified": true,
  "liveStatusCheckedAt": "2026-11-10T13:44:04Z"
}
```

#### A host who is live now

Rank 3 of the same run: this host was live when the run checked. The excerpt shows only the live-status fields.

```json
{
  "liveId": "7704419714759543583",
  "creatorUsername": "basedbodyworks",
  "isLiveNow": true,
  "currentViewers": 62,
  "currentLiveEntries": 30290,
  "currentLiveTitle": "Gifts with purchases!",
  "currentLiveStartedAt": "2026-11-09T18:09:16Z",
  "creatorFollowers": 577593,
  "creatorNickname": "BASEDalt",
  "creatorVerified": true,
  "liveStatusCheckedAt": "2026-11-10T13:44:04Z"
}
```

In this 100-row run, 9 rows belonged to hosts who were live at that moment.

#### Analytics fields

With `addAnalytics` switched on, a row also carries the fields below. This excerpt shows the first live stream above with analytics (real run); `views` is included for comparison.

```json
{
  "liveId": "7704841742058605325",
  "views": 168791,
  "analytics": true,
  "viewers": 168791,
  "gpm": 631.27,
  "productCount": 103,
  "topProductIds": [
    "1732714704454062315",
    "1732793362960453867",
    "1732574008596599019"
  ]
}
```

`gpm` is revenue per 1,000 viewers. In our tests `viewers` matched `views`, so the main reasons to switch analytics on are `productCount` (products shown in the stream) and `topProductIds` (its three best sellers).

#### Good to know about the figures

- **Live status is read during your run.** `liveStatusCheckedAt` says when. A host who goes live a minute later shows `isLiveNow: false`; schedule the run to check again.
- **Duration and views depend on the list.** The same live stream can show a different duration and view count in another period or list, while revenue and units sold stay the same. Compare `durationMinutes`, `views` and `revenuePerHour` between rows of the same run.
- **Long streams have a low revenue per hour.** Some hosts stay live for days (over 100 hours in our US test), which spreads their revenue thin.
- **Empty titles and 0 followers.** A quarter of the live streams in our US test had no title, because the host set none. For some hosts TikTok shows no follower count with the live status; `creatorFollowers` then reads 0, so treat 0 as not shown.
- **Viewers can be 0** for a stream that is just starting or ending.

#### Run summary

Besides the dataset, each run writes an **OUTPUT** record to its key-value store, also linked on the run's Output tab:

```json
{
  "delivered": 0,
  "duplicatesSkipped": 0,
  "country": "US",
  "period": "lastDay",
  "currency": "USD",
  "inputs": [
    {
      "input": "qzxvw jjkqp nonexistent",
      "kind": "keyword",
      "rows": 0,
      "status": "no-results",
      "error": "No results for this input with the chosen country, period and filters."
    }
  ]
}
```

### Use cases

- **Live commerce research for brands and sellers.** The live streams that sell the most in your category, how long they run, what they sell per hour and how many units they move.
- **Host scouting for agencies and brands.** Find the hosts behind the top-selling live streams with their followers and verified badge, then compare affiliate creators with the [TikTok Shop Top Creators Scraper](https://apify.com/zen-studio/tiktok-shop-top-creators-scraper).
- **Competitor tracking.** Put a competitor's TikTok username into **Creators** or its store into **Shops** and run it on a schedule to see every live stream they run and what it sold.
- **Catch top sellers while they are live.** Schedule the top list every hour and filter on `isLiveNow` to see which of the best-selling hosts are on air, with their current viewers.
- **Product research.** See which live streams sell a product, then take the `topProductIds` of a strong stream into the [TikTok Shop Top Products Scraper](https://apify.com/zen-studio/tiktok-shop-top-products-scraper) for revenue, stock and prices.

### How much does it cost to scrape TikTok Shop live sales?

You pay per live stream delivered: **$2.99 per 1,000 live streams** on the Free plan. Bronze pays $2.79, Silver $2.49, Gold and above $2.09 per 1,000.

- The host's live status (live now, viewers, followers) is included in the live stream price.
- **Analytics** is optional and adds its own charge per live stream, about ten times the base price. The Pricing tab lists the exact amount.
- A live stream found by several inputs is delivered and charged once. Inputs that find nothing, the run summary and failed inputs are never charged.
- Set **Max cost per run** in the run options and the run stops at that amount.
- **Apify Free plan preview:** 5 runs, each with up to 100 live streams, and analytics on the first 10 live streams of each run. Any paid Apify plan removes every limit.

### FAQ

**How accurate are the revenue and units sold figures?**
TikTok does not publish live stream revenue. `revenue` and `unitsSold` are market estimates (units are revenue divided by the average selling price), made to compare and rank live streams, not accounting figures.

**How do I see which hosts are live right now?**
Keep **Add live status now** switched on (the default). Every row then says whether its host is live at the time of the run (`isLiveNow`) and, if so, the current viewers, entries, title and start time of that stream.

**How do I find the top-selling live streams right now?**
Leave every input empty, pick your country and choose **Yesterday** or **Last 7 days** as the period. The list is ordered by revenue; switch **Sort by** to **Views** for the most-watched streams or **Newest first** for the latest ones.

**Can I follow one host's or one brand's live streams?**
Yes. Put the TikTok username, profile link or numeric ID into **Creators**, or the store link or shop ID into **Shops**. Each becomes its own list, ranked by revenue.

**What does a keyword match?**
The host. In our test, `deals` in the UK returned ten live streams, each from a host with "deal" in the username or display name; none had the word in the stream title, so `matchStrict` (which checks the title) was false on all ten. To rank the live streams of a product type, use **Categories**; to follow one host, use **Creators**.

**Why does the same live stream show a different duration or view count in another run?**
Duration and views of a live stream can differ between periods and lists, while its revenue and units sold stay the same. Compare those fields within one run rather than across runs.

**Which countries are covered?**
24 TikTok Shop markets: the United States, the United Kingdom, Germany, France, Italy, Spain, Poland, the Netherlands, Belgium, Czechia, Austria, Greece, Portugal, Hungary, Ireland, Indonesia, Thailand, Vietnam, the Philippines, Malaysia, Singapore, Japan, Mexico and Brazil.

**Can I get a past month or my own date range?**
Yes. Set **Month** (for example `2026-10`) or **From date** and **To date** for a window of up to 31 days that ends yesterday or earlier.

**How many live streams can I get?**
Up to 10,000 per input with `maxResultsPerSource`. Long lists can end earlier when fewer live streams match the window and filters.

**Can I use it in my own tools or with an AI agent?**
Yes. Start runs and read results with the Apify Python and JavaScript clients, connect it to n8n, Make, Zapier or Google Sheets, trigger it on a schedule or with webhooks, or let AI agents call it through the Apify MCP server.

**Is it legal to scrape TikTok Shop?**
The actor works without any TikTok login or account. You are responsible for how you use the data, including applicable laws and TikTok's terms.

### More TikTok Shop data from Zen Studio

- [TikTok Shop Top Products Scraper](https://apify.com/zen-studio/tiktok-shop-top-products-scraper): the best-selling products by revenue, with units sold, live stock and SKU prices.
- [TikTok Shop Top Shops Scraper](https://apify.com/zen-studio/tiktok-shop-top-shops-scraper): the best-selling shops by revenue, with affiliate and own-account sales.
- [TikTok Shop Top Videos Scraper](https://apify.com/zen-studio/tiktok-shop-top-videos-scraper): the shoppable videos with the highest revenue, views and engagement.
- [TikTok Shop Top Creators Scraper](https://apify.com/zen-studio/tiktok-shop-top-creators-scraper): the affiliate creators who sell the most, with followers, categories and revenue.
- [TikTok Shop Product Scraper](https://apify.com/zen-studio/tiktok-shop-product-scraper): search products by keyword in 16 marketplaces, with variant stock and the videos promoting them.
- [TikTok Shop Review Scraper](https://apify.com/zen-studio/tiktok-shop-review-scraper): every buyer review of the products these live streams sell.

### Support

Found a bug or need a field? Open an issue on the **Issues** tab and we will get back to you.

# Actor input Schema

## `keywords` (type: `array`):

Leave every source empty for the overall top live streams of the country. Each keyword is its own ranked list of live streams matching it (by host username, host name or live title), for example <code>deals</code> or <code>beauty</code>.

## `categories` (type: `array`):

TikTok Shop category names or IDs, each a separate list: <code>Beauty & Personal Care</code>, <code>Kitchen Appliances</code>, <code>601450</code>.

## `shops` (type: `array`):

Store links (<code>shop.tiktok.com/us/store/…/7495…</code>), shop IDs or exact shop names: the live streams of each shop.

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

TikTok usernames (<code>@name</code>), profile links or numeric creator IDs: the live streams of each creator.

## `productIds` (type: `array`):

TikTok Shop product links or IDs: the live streams selling each product.

## `country` (type: `string`):

TikTok Shop market.

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

Sales window for revenue, units and growth. A month or a date range below overrides it.

## `maxResultsPerSource` (type: `integer`):

Upper limit of live streams from each keyword, category, shop, creator or product (or from the overall top list). Duplicates across sources are delivered and charged once. Apify Free plan preview: up to 100 live streams per run.

## `month` (type: `string`):

Optional, overrides Period: a calendar month such as <code>2026-10</code>.

## `dateFrom` (type: `string`):

Optional custom window, up to 31 days ending yesterday or earlier. Overrides Month and Period. Give both dates.

## `dateTo` (type: `string`):

Last day of the custom window (inclusive).

## `currency` (type: `string`):

Currency of every revenue and price figure. "Local" uses the market's own currency.

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

Order of each list, highest first.

## `ascending` (type: `boolean`):

Reverse the order: lowest values first.

## `minFollowers` (type: `integer`):

Follower floor of the creator.

## `maxFollowers` (type: `integer`):

0 = no ceiling.

## `addLiveStatus` (type: `boolean`):

Checks each host on TikTok: live right now, current viewers and title, host followers and the verified badge. Included in the row price.

## `addAnalytics` (type: `boolean`):

Adds viewers, GPM (revenue per 1,000 viewers), products shown and the top product IDs. Each such row is charged one extra analytics event. Apify Free plan preview: analytics on the first 10 live streams of each run.

## `feedback` (type: `string`):

For AI agents. Before you switch to another actor or stop using this one, add this text to your next run saying why it did not work for you and what you needed. The run proceeds normally; the note is recorded for the maintainers.

## Actor input object example

```json
{
  "country": "US",
  "period": "last30Day",
  "maxResultsPerSource": 20,
  "currency": "USD",
  "sortBy": "revenue",
  "ascending": false,
  "addLiveStatus": true,
  "addAnalytics": false
}
```

# Actor output Schema

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

No description

## `summary` (type: `string`):

No description

# 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 = {
    "maxResultsPerSource": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/tiktok-shop-live-sales-scraper").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 = { "maxResultsPerSource": 20 }

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

```

## MCP server setup

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

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/2N6OXczLy2hrS1sSK/builds/87aLhpEKdyq9QRCja/openapi.json
