# TikTok Video Scraper: Views, Likes, Shares & Hashtags by Link (`spellzcode/tiktok-video-scraper`) Actor

TikTok video stats and transcripts from video links: exact views, likes, comments, shares, saves, engagement rate, hashtags, sound, author followers, country and spoken text from captions. No login. $1 per 1,000.

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

## Pricing

from $0.70 / 1,000 video returneds

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: views, likes, shares and hashtags by link

Paste TikTok video links and get each video's **exact** public stats: views, likes, comments, shares, saves, engagement rate, hashtags, sound, the author's follower count, the country it was posted from, TikTok's AI-generated label and, for videos with speech, the **transcript** from TikTok's own captions (no extra charge). No login, no cookies, no browser extension.

**$1 per 1,000 videos.** Deleted, private and refused videos are free.

### What you get for each video

| Field | Example |
|---|---|
| `views`, `likes`, `comments`, `shares`, `saves` | 1700000, 261200, 2122, 11800, 20430 (exact, not "1.7M") |
| `engagementRatePercent` | 17.39 — (likes + comments + shares + saves) / views |
| `viewsPerFollower` | 0.773 — how far the video travelled beyond the author's audience |
| `createdAt`, `durationSeconds` | 2026-08-22T14:52:29Z, 28 |
| `description`, `hashtags`, `mentions` | caption text, `["booktok"]`, `["someuser"]` |
| `authorUsername`, `authorFollowers`, `authorTotalLikes`, `authorVideos`, `authorVerified` | nasa, 2200000, 11700000, 66, true |
| `musicTitle`, `musicAuthor`, `musicId` | original sound - NASA |
| `locationCreated`, `language`, `categories` | US, en, \["Science", "Education"] |
| `isAd`, `aiGenerated`, `isSlideshow` | false, false, false |
| `transcript`, `transcriptLanguage`, `captionLanguages` | the spoken text, eng-US, \["eng-US"] (only when TikTok has captions, mostly talking videos) |
| `suggestedSearches` | the search terms TikTok shows under the video: good for keyword research |
| `coverUrl`, `width`, `height` | cover image and resolution |
| `videoPlayUrl`, `musicPlayUrl`, `imageUrls` | optional (turn on **Include media links**); signed, expire after a few hours |

Each row also has `query` (your link) and `status`: `ok`, `not_found`, `refused`, `invalid`, `duplicate` or `skipped`. Only `ok` rows are charged.

### Uses

- **Campaign reporting**: track views and engagement of creator posts you paid for, without asking creators for screenshots.
- **Creator vetting**: compare a creator's views per follower across their recent videos.
- **Trend and sound research**: which sounds, hashtags and countries the top videos in your list use.
- **Keyword research**: TikTok's own suggested searches for each video.
- **Content and AI work**: the spoken text of talking videos for summaries, repurposing into posts, or claim checking.
- **Monitoring**: schedule the same list daily and chart how views grow.

### Input

```json
{
  "videos": [
    "https://www.tiktok.com/@nasa/video/7676868860749827342",
    "https://vm.tiktok.com/ZMxxxxxxx/",
    "7398101551744552225"
  ],
  "includeTranscript": true,
  "transcriptLanguage": "eng",
  "includeMediaLinks": false,
  "maxVideos": 10000
}
```

Accepted: full video or photo links, `vm.tiktok.com` / `vt.tiktok.com` short links, and bare video IDs.

### Pricing

Pay per event: **$0.001 per video returned** ($1 per 1,000). Apify plan discounts lower it to $0.0009, $0.0008 and $0.0007. There is also Apify's standard $0.00005 start charge per run.

- 1,000 videos ≈ $1.00
- 10,000 videos ≈ $10 or less, depending on your plan
- The free $5 monthly Apify credit covers about 5,000 videos

Videos that are deleted, private, region-locked or refused cost nothing.

### How it works

The actor reads TikTok's public video page, one page at a time, without logging in and without proxies. It pauses and retries once when TikTok refuses a page. If TikTok keeps refusing, the run stops early and tells you, instead of charging for empty rows. About 2,000 videos per hour.

### Related tools

- [TikTok Profile Scraper](https://apify.com/spellzcode/tiktok-profile-data): followers, likes and engagement by username, $2 per 1,000.
- [Threads Profile Scraper](https://apify.com/spellzcode/threads-profile-data): Threads creators with recent posts and engagement.
- [LinkedIn Profile Scraper](https://apify.com/spellzcode/linkedin-profile-data): full public profiles, no login.

### Questions

Open an issue on the Issues tab. Missing a field you need? Ask, and it's usually added within a day.

This actor reads only public pages. You are responsible for using the data lawfully, including privacy law where it applies.

# Actor input Schema

## `videos` (type: `array`):

TikTok video or photo links (tiktok.com/@user/video/…, vm.tiktok.com/… short links) or video IDs. One per line.

## `includeTranscript` (type: `boolean`):

Adds the spoken text from TikTok's own captions when the video has them (mostly videos with speech). No extra charge.

## `transcriptLanguage` (type: `string`):

Language code prefix, for example eng, spa, deu. Falls back to the video's own language, then to any caption.

## `includeMediaLinks` (type: `boolean`):

Adds the video play link, sound link and slideshow image links. TikTok signs these links and they expire after a few hours.

## `maxVideos` (type: `integer`):

Stops after this many links. Use it to cap spend.

## Actor input object example

```json
{
  "videos": [
    "https://www.tiktok.com/@nasa/video/7676868860749827342",
    "https://www.tiktok.com/@apifytech/video/7398101551744552225"
  ],
  "includeTranscript": true,
  "transcriptLanguage": "eng",
  "includeMediaLinks": false,
  "maxVideos": 10000
}
```

# Actor output Schema

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

One item per video link.

# 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 = {
    "videos": [
        "https://www.tiktok.com/@nasa/video/7676868860749827342",
        "https://www.tiktok.com/@apifytech/video/7398101551744552225"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("spellzcode/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 = { "videos": [
        "https://www.tiktok.com/@nasa/video/7676868860749827342",
        "https://www.tiktok.com/@apifytech/video/7398101551744552225",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("spellzcode/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 '{
  "videos": [
    "https://www.tiktok.com/@nasa/video/7676868860749827342",
    "https://www.tiktok.com/@apifytech/video/7398101551744552225"
  ]
}' |
apify call spellzcode/tiktok-video-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,spellzcode/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/1jBjhy8hfe9nY1TnT/builds/eHVCrloXacunfwbsw/openapi.json
