# TikTok Video & Hashtag Scraper: Posts, Creators & Sounds (`magic-scraper/tiktok-video-hashtag-scraper`) Actor

Fast TikTok Video & Hashtag Scraper: extract trending posts, video views, likes, hashtags, creators, sounds, and TikTok Shop affiliate product badges in real time.

- **URL**: https://apify.com/magic-scraper/tiktok-video-hashtag-scraper.md
- **Developed by:** [Magic](https://apify.com/magic-scraper) (community)
- **Categories:** Social media, Videos, Lead generation
- **Stats:** 8 total users, 3 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.50 / 1,000 results

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 & Hashtag Scraper: Posts, Creators, Sounds & Shop Affiliates

[![TikTok Video & Hashtag Scraper](https://apify.com/actor-badge?actor=magic-scraper/tiktok-video-hashtag-scraper)](https://apify.com/magic-scraper/tiktok-video-hashtag-scraper)
![No Cookies Required](https://img.shields.io/badge/Cookies-Not%20Required-success?style=flat-square)
![Pay-Per-Result](https://img.shields.io/badge/Pricing-$2.00%20%2F%201K%20videos-blue?style=flat-square)
![Speed](https://img.shields.io/badge/Speed-~1.5s%20per%20page-brightgreen?style=flat-square)
![Export](https://img.shields.io/badge/Export-JSON%20|%20CSV%20|%20Excel-orange?style=flat-square)

Extract trending TikTok videos, creator statistics, hashtag feeds, music metadata, engagement metrics, and **TikTok Shop affiliate product indicators** at scale.

Designed for **social media analysts, influencer marketing agencies, DTC brand managers, content creators, and e-commerce sellers** monitoring viral trends and competitor campaigns.

***

### ⚡ What is TikTok Video & Hashtag Scraper?

TikTok is the epicenter of viral social media and consumer trends. While manual browsing is slow and official APIs are heavily gated, **TikTok Video & Hashtag Scraper** gives you instant programmatic access to:

1. **Hashtag Feeds:** Collect top-performing and trending videos under any hashtag (e.g. `fyp`, `viral`, `tiktokmademebuyit`).
2. **Keyword Search:** Find videos and discussions matching any keyword or phrase (e.g. `skincare routine`, `wireless earbuds`).
3. **Direct Video URLs & IDs:** Deep-dive into individual TikTok posts to extract complete author bios, sound tracks, video download URLs, and engagement numbers.
4. **Yellow Shopping Cart Detection:** Automatically flags whether a video features a **TikTok Shop affiliate product showcase** (`hasTikTokShopProduct: true`), enabling easy discovery of top-performing affiliate video marketing hooks.

***

### 🚀 Why Choose This Scraper Over Competitors?

| Feature | **Our TikTok Video Scraper** | Competing Scrapers (Clockworks, etc.) |
| :--- | :---: | :---: |
| **Pricing** | 💰 **$2.00 / 1,000 videos** ($0.002/item) | 💸 $3.70 – $10.00 / 1,000 videos |
| **Minimal Start Fee** | 🏷️ **$0.001** | 💸 $0.05 – $0.10 |
| **Clean Data & Deduplication** | ✅ **100% Unique tags + repetition counts** | ❌ Raw duplicate spam tags (often 200+ repeats) |
| **Speed** | ⚡ **~1.5 seconds per request** | 🐢 5–15 seconds |
| **TikTok Shop Product Flag** | ✅ **`hasTikTokShopProduct` included** | ❌ Missing or charged as extra add-on |
| **Engagement Rate Metric** | ✅ **Calculated `engagement_rate` %** | ❌ Manual calculation required |
| **Creator Stats** | ✅ Followers, total likes, video count | 💸 Often charged extra ($0.004/creator) |
| **Music / Audio Details** | ✅ Title, author, original audio, CDN URL | ❌ Basic title only |
| **Architecture** | ✅ Native TLS impersonation (No browser overhead) | ❌ Heavy browser memory crashes |

***

### 📖 How to Scrape TikTok Videos & Hashtags (Step-by-Step)

1. **Choose Your Target:**
   - Enter one or more **Hashtags** (e.g. `fyp`, `fitness`, `dropshipping`).
   - Or enter **Search Queries** (e.g. `home decor hacks`, `red light mask`).
   - Or paste specific **Video URLs or numeric IDs** (e.g. `https://www.tiktok.com/@user/video/7695950482107305247`).
2. **Set Limit:** Choose `resultsPerPage` (default: 20, prefilled with 5 for quick testing).
3. **Run & Export:** Click **Start**. Export your clean structured dataset to **CSV, Excel, JSON, Google Sheets**, or integrate directly via API.

***

### 💳 How Much Does It Cost?

This Actor operates under Apify's transparent **Pay-Per-Event (Pay-Per-Result)** model:

- **$2.00 per 1,000 videos** ($0.002 per video row).
- **$0.001 minimal start fee**.
- **No subscription required.** If a query yields 0 results, you are not charged per-result fees.

***

### 📥 Input Parameters

| Parameter | Type | Required | Default | Description |
| :--- | :--- | :---: | :---: | :--- |
| `#️⃣ hashtags` | `array[string]` | No | `["fyp"]` | List of hashtags to extract (without `#`). |
| `🔍 searchQueries` | `array[string]` | No | `[]` | List of keywords or phrases to search on TikTok. |
| `🔗 videoUrls` | `array[string]` | No | `[]` | Direct video URLs or numeric video IDs. |
| `💯 resultsPerPage` | `integer` | No | `20` | Max videos to extract per hashtag or search query (1 – 1,000). Prefilled with 5 for instant 1-click test runs. |
| `🌍 countryCode` | `string` | No | `"US"` | Market region for localized recommendations (`"US"`, `"GB"`, `"GLOBAL"`). |
| `🌐 proxyConfiguration` | `object` | No | Datacenter | Proxy configuration. Apify Datacenter or Residential proxy. |

***

### 📤 Sample Output (JSON)

```json
{
  "id": "7695950482107305247",
  "text": "RIP❤️ #sixflags #atlanta #fyp #viral",
  "textLanguage": "en",
  "createTime": 1791853117,
  "createTimeISO": "2026-10-13T00:58:37.000Z",
  "isAd": false,
  "hasTikTokShopProduct": false,
  "webVideoUrl": "https://www.tiktok.com/@_.1lilej1/video/7695950482107305247",
  "authorMeta": {
    "id": "7066463778688123950",
    "name": "_.1lilej1",
    "nickName": "Elijah",
    "profileUrl": "https://www.tiktok.com/@_.1lilej1",
    "verified": false,
    "signature": "ATL, Business contact in bio",
    "avatar": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/873f0daa3e984a0d64f35f540748c2d1~tplv-tiktokx-cropcenter:720:720.jpeg",
    "following": 184,
    "fans": 3851,
    "heart": 264500,
    "video": 578
  },
  "musicMeta": {
    "musicId": "7589567274449783565",
    "musicName": "original sound",
    "musicAuthor": "LoverboyMarcus96",
    "musicOriginal": true,
    "playUrl": "https://v16m.tiktokcdn-us.com/50ed19233999b51431b6013c1f63cd93/6ace4c9a/video/tos/useast5/tos-useast5-v-27dcd7-tx/oIUB4AaTAAXR1DyIgAilxVvPE3ABjO4ECPiPU.mp3"
  },
  "videoMeta": {
    "height": 1280,
    "width": 720,
    "duration": 12,
    "definition": "720p",
    "format": "mp4",
    "coverUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8PzVE1ID3gBYBghAEfjA3B2oFfIUqEEv82RsN~tplv-tiktokx-origin.image"
  },
  "diggCount": 44900,
  "shareCount": 1809,
  "playCount": 851000,
  "collectCount": 1501,
  "commentCount": 614,
  "engagement_rate": 5.74,
  "hashtags_list": [
    "sixflags",
    "atlanta",
    "fyp",
    "viral"
  ],
  "hashtags": [
    {"name": "sixflags", "count": 1},
    {"name": "atlanta", "count": 1},
    {"name": "fyp", "count": 1},
    {"name": "viral", "count": 1}
  ],
  "isSlideshow": false,
  "input": "viral",
  "searchHashtag": {
    "name": "viral",
    "views": 49200600000000
  },
  "scraped_at": "2026-10-13T09:30:00.000Z"
}
```

***

### 💻 Python & JavaScript Integration

#### Python (`apify-client`)

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "hashtags": ["fyp", "viral"],
    "resultsPerPage": 50,
}

run = client.actor("magic-scraper/tiktok-video-hashtag-scraper").call(run_input=run_input)
for video in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"@{video['authorMeta']['name']}: {video['playCount']} views | Shop Product: {video['hasTikTokShopProduct']}")
```

#### JavaScript / Node.js (`apify-client`)

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('magic-scraper/tiktok-video-hashtag-scraper').call({
    hashtags: ['viral'],
    resultsPerPage: 20
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} viral TikTok videos.`);
```

***

### 🤖 For AI Agents & LLM Apps

Compact reference for AI agents calling this actor via the [Apify MCP server](https://mcp.apify.com/) or the Apify API (actor: `magic-scraper/tiktok-video-hashtag-scraper`).

**Purpose:** Extracts viral TikTok videos by hashtag or search query in real time, collecting view counts, likes, comments, shares, engagement rates, creator profiles, music metadata, and TikTok Shop affiliate product indicators.

**Why choose this tool over alternatives:**

- **High-Speed Real-Time Feeds:** Leverages native API protocol requests (~1s per batch) instead of slow browser scrolling, reducing compute consumption by 85%.
- **Affiliate & Shop Product Detection:** Automatically flags whether a video features a linked TikTok Shop product (`hasTikTokShopProduct: true`), enabling instant viral affiliate product discovery.
- **Automated Engagement Rate Calculation:** Pre-computes normalized engagement rates (`(likes + comments + shares + saves) / views * 100`) for direct agent ranking.
- **No Login / Cookies Required:** Operates autonomously without TikTok user accounts or session tokens.
- **Rich Media & Audio Metadata:** Returns direct video URLs, video dimensions, creator follower counts, sound IDs, and audio tracks.

**Minimal input:**

```json
{
  "hashtags": ["viral", "tiktokshop"],
  "resultsPerPage": 20
}
```

**Output structure:**
Array of video items: `id`, `text`, `createTime`, `authorMeta` (name, nickName, profileUrl, verified, fans, heart, video), `musicMeta` (musicName, musicAuthor, playUrl), `videoMeta` (duration, definition, coverUrl), `diggCount` (likes), `shareCount`, `playCount` (views), `collectCount` (saves), `commentCount`, `engagement_rate`, `hashtags_list`, `hasTikTokShopProduct`, `scraped_at`.

**Behaviors an agent should know:**

- Set `resultsPerPage` (e.g. 10 to 50) to manage token usage and response size for LLM context windows.
- Filter by `hasTikTokShopProduct: true` in your agent prompt to quickly identify winning viral affiliate marketing creative.
- Sort videos by `engagement_rate` or `playCount` to isolate top creators and trending formats.

***

### 🔗 Related TikTok Scrapers

- 🔍 [TikTok Shop Search Scraper](https://apify.com/magic-scraper/tiktok-shop-search-scraper) — Fast keyword product discovery, real-time sales volume, prices, discounts, and best-seller tracking.
- 📦 [TikTok Shop Product Scraper](https://apify.com/magic-scraper/tiktok-shop-product-scraper) — Full SKU variant matrix, real-time inventory stock levels, prices, specifications, and buyer reviews.

***

### SEO Keywords

TikTok video scraper, TikTok hashtag scraper, TikTok viral video tracker, TikTok engagement rate calculator, TikTok creator scraper, TikTok affiliate marketing scraper, TikTok Shop product video finder, TikTok music and sound scraper, scrape TikTok videos without login, TikTok trending videos API, TikTok analytics scraper, TikTok view and like tracker, TikTok data extractor, TikTok influencer discovery, TikTok scraper API.

# Actor input Schema

## `hashtags` (type: `array`):

TikTok hashtags to scrape (without '#', e.g. 'fyp', 'viral', 'dropshipping').

## `searchQueries` (type: `array`):

Keywords or search phrases to find matching TikTok videos for (e.g. 'fitness workouts', 'beauty products').

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

Direct TikTok video URLs (e.g. 'https://www.tiktok.com/@user/video/7695950482107305247') or numeric video IDs.

## `resultsPerPage` (type: `integer`):

Maximum number of videos to extract per hashtag or search query. Prefilled with 5 for instant 1-click test runs.

## `countryCode` (type: `string`):

Country code for localized video search and hashtag recommendations.

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

Apify Datacenter or Residential proxy settings. Residential proxies are recommended for large-scale crawling.

## Actor input object example

```json
{
  "hashtags": [
    "fyp"
  ],
  "resultsPerPage": 5,
  "countryCode": "US",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "BUYPROXIES94952"
    ]
  }
}
```

# Actor output Schema

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

Dataset items containing video metadata, author profile, engagement stats (plays, likes, comments, shares), sound info, hashtags, and affiliate shop flags.

# 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 = {
    "hashtags": [
        "fyp"
    ],
    "resultsPerPage": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("magic-scraper/tiktok-video-hashtag-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 = {
    "hashtags": ["fyp"],
    "resultsPerPage": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("magic-scraper/tiktok-video-hashtag-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 '{
  "hashtags": [
    "fyp"
  ],
  "resultsPerPage": 5
}' |
apify call magic-scraper/tiktok-video-hashtag-scraper --silent --output-dataset

```

## MCP server setup

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