# TikTok Video Scraper (`lergassy/tiktok-video-scraper`) Actor

\[$1/1K videos] Full stats for any TikTok video URL: views, likes, comments, shares, saves, date, duration, caption, hashtags, music, country, subtitles, and the author with followers. Profiles too. No login, no run fee.

- **URL**: https://apify.com/lergassy/tiktok-video-scraper.md
- **Developed by:** [Matvey](https://apify.com/lergassy) (community)
- **Categories:** Social media, Videos, Agents
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 videos

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 Video Scraper** takes **TikTok video URLs** (or profiles) and returns one row per video with every public number: **views, likes, comments, shares, saves, reposts, engagement rate, publish time, duration, caption, hashtags, mentions, music, country, language, AI label, subtitle files, cover**, and the **author with followers, total likes and video count**.

**$0.001 per video** — $1 per 1,000. No TikTok account, no cookies, no login, no start fee. Videos removed by your filters and links that fail are free.

### What is TikTok Video Scraper?

You have a list of TikTok links — from a campaign, an influencer report, a competitor tracker — and need the numbers behind them. This Actor opens each video the way the TikTok website does and turns it into a clean row. Use it to report campaign results, audit influencer posts, track competitors' videos over time, or feed TikTok data to an AI agent.

### What is in every row

| Field | Meaning |
|---|---|
| `views`, `likes`, `comments`, `shares`, `saves`, `reposts`, `engagementRate` | Every public counter |
| `createdAt`, `durationSeconds`, `description`, `hashtags`, `mentions` | The post |
| `musicTitle`, `musicAuthor`, `musicOriginal` | The sound |
| `locationCreated`, `language`, `isAd`, `isAiGenerated`, `suggestedWords` | Context |
| `subtitles`, `coverUrl`, `playUrl`, `imageUrls` | Media links (subtitles = TikTok's auto-captions) |
| `authorUsername`, `authorFollowers`, `authorLikes`, `authorVideos`, `authorVerified` | The creator |

### How much does it cost?

| Event | Price |
|---|---|
| Video | **$0.001** |

- Videos below **Minimum views** or older than **Published after**: **$0**.
- Private, removed or broken links: **$0** (an error row says why).

#### Bulk export: what 50,000 rows actually cost

This Actor is built for bulk jobs — thousands of inputs in one run, or a daily schedule. There is **no
fee per run, no fee per page and no proxy charge**: you pay for the rows you keep.

| Job | This Actor | Most-used Actor in this category |
|---|---|---|
| 50,000 videos across 100 runs | **$50** | $150 |
| 2,000 campaign videos re-checked weekly for a month | **$8** | $24 |

Checked on the Apify Store on 23 September 2026 against the Actor with the most monthly users in this category
($0.003 per video). Some Actors here ask less per row — this table compares against the one buyers actually use most.

### How to use it in three steps

1. Paste TikTok video links (or profiles) — one per line.
2. Set **Minimum views** or **Published after** if you want only some of them.
3. Press **Start**, then download JSON, CSV or Excel — or call the run from the API, n8n, Make, Zapier or an AI agent.

### ⬇️ Input

```json
{
  "videoUrls": ["https://www.tiktok.com/@nike/video/7688359466324004110", "https://vm.tiktok.com/ZMxxxxxx/"],
  "profiles": ["khaby.lame"],
  "minViews": 10000
}
```

### ⬆️ Output

```json
{
  "type": "video",
  "input": "https://www.tiktok.com/@nike/video/7688359466324004110",
  "videoId": "7688359466324004110",
  "url": "https://www.tiktok.com/@nike/video/7688359466324004110",
  "description": "*Just a normal day for Caitlin Clark. Wake up. Eat cereal. Lace up the Caitlin 1. Sell out arenas. Repeat. Caitlin 1 Signature Collection drops October 1st.",
  "createdAt": "2026-09-22T14:02:11.000Z",
  "views": 75000,
  "likes": 13700,
  "comments": 185,
  "shares": 787,
  "saves": 729,
  "reposts": 0,
  "engagementRate": 19.56,
  "durationSeconds": 30,
  "width": 720,
  "height": 1280,
  "definition": "720p",
  "coverUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-p-0068-…",
  "playUrl": "https://v16-webapp-prime.us.tiktok.com/video/tos/u…",
  "imageUrls": [],
  "subtitles": [
    {
      "language": "eng-US",
      "url": "https://v16m-webapp.tiktokcdn-us.com/2f527891e0101e6f1ef60e10ba799287/6ab67478/video/tos/useast5/tos-useast5-v-0068-tx/8de3e95446914c138392834cc5c50239/?a=1988&bti=ODszNWYuMDE6&&bt=439&ft=4KLMeMzm8Zmo0YOB0a4jVsAhQpWrKsd.&mime_type=video_mp4&rc=M2psbWs5cmY7ZDMzZzczNEBpM2psbWs5cmY7ZDMzZzczNEBiMHFmMmRzaG1hLS1kMS9zYSNiMHFmMmRzaG1hLS1kMS9zcw%3D%3D&l=202609231317140FB1CD2277D4F911CCF8&btag=e00048000",
      "source": "ASR"
    }
  ],
  "hashtags": [],
  "mentions": [],
  "suggestedWords": [
    "Caitlin Clark",
    "caitlin clark cereal",
    "caitlin",
    "caitlin clark dress"
  ],
  "language": "en",
  "locationCreated": "US",
  "isAd": false,
  "isAiGenerated": false,
  "aiLabel": null,
  "commentsDisabled": false,
  "musicId": "7688359648679774990",
  "musicTitle": "original sound",
  "musicAuthor": "Nike",
  "musicOriginal": true,
  "musicDurationSeconds": 30,
  "musicAlbum": null,
  "authorUsername": "nike",
  "authorNickname": "Nike",
  "authorId": "208464585232822272",
  "authorSecUid": "MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_",
  "authorVerified": true,
  "authorSignature": "Just Do It.",
  "authorFollowers": 9200000,
  "authorFollowing": 90,
  "authorLikes": 49100000,
  "authorVideos": 1089,
  "authorAvatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useas…",
  "authorProfileUrl": "https://www.tiktok.com/@nike",
  "scrapedAt": "2026-09-23T13:17:14.799Z"
}
```

### Use cases

#### Campaign reporting

All influencer posts of a campaign with views, likes, comments and saves — one table, one minute.

#### Influencer audits

Real engagement of a creator's recent videos, plus followers and total likes.

#### Competitor tracking

Re-run the same links weekly and chart how videos grow.

#### AI and research

Captions, hashtags, auto-captions and numbers through the Apify MCP server or API.

### Integrations

Every run is available through the Apify API, and the Actor works out of the box with n8n, Make, Zapier, Google Sheets, LangChain and the Apify MCP server.

### FAQ

**Do I need a TikTok account?** No. Nothing is logged in.

**How many videos per profile?** The latest ~10 public videos that TikTok shows to visitors. For long histories paste the video links.

**Can I download the video?** `playUrl` is TikTok's stream link and expires after a few hours; the Actor does not store video files.

**Are subtitles included?** `subtitles` lists TikTok's caption files (usually auto-generated) with their language.

**Is this legal?** The Actor reads public pages that anyone can open without logging in. Use the data in line with TikTok's terms and your local law.

# Changelog

This Actor's version history is a separate document: https://apify.com/lergassy/tiktok-video-scraper/changelog.md

# Actor input Schema

## `videoUrls` (type: `array`):

Video or photo links (tiktok.com/@user/video/…, vm.tiktok.com short links) or bare video ids. Thousands per run.

## `profiles` (type: `array`):

Usernames or profile links — the latest ~10 public videos of each profile, with full stats.

## `minViews` (type: `integer`):

Skip videos with fewer views. Skipped videos are not charged.

## `publishedAfter` (type: `string`):

Keep only videos published on or after this date. Older ones are not charged.

## `concurrency` (type: `integer`):

How many videos to read at the same time.

## `proxyConfiguration` (type: `object`):

Requests go to TikTok directly first; a refused request is retried on a fresh Apify datacenter address. Residential is never switched on by itself.

## Actor input object example

```json
{
  "videoUrls": [
    "https://www.tiktok.com/@nike/video/7688359466324004110",
    "https://www.tiktok.com/@nike/video/7685763460491169037"
  ],
  "minViews": 0,
  "concurrency": 5,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One row per TikTok video: views, likes, comments, shares, saves, music, author.

## `runSummary` (type: `string`):

JSON summary of the run: rows delivered, rows filtered out, failed inputs (free) and request statistics.

# 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 = {
    "videoUrls": [
        "https://www.tiktok.com/@nike/video/7688359466324004110",
        "https://www.tiktok.com/@nike/video/7685763460491169037"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("lergassy/tiktok-video-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 = {
    "videoUrls": [
        "https://www.tiktok.com/@nike/video/7688359466324004110",
        "https://www.tiktok.com/@nike/video/7685763460491169037",
    ],
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("lergassy/tiktok-video-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 '{
  "videoUrls": [
    "https://www.tiktok.com/@nike/video/7688359466324004110",
    "https://www.tiktok.com/@nike/video/7685763460491169037"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call lergassy/tiktok-video-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lergassy/tiktok-video-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/AQKfuNWNpDNbruSff/builds/mzOH9IjPolW9XaPVZ/openapi.json