# TokScrape Max — TikTok Viral Intelligence Engine (`edgeofcali/tokscrape-max`) Actor

TokScrape Max — TikTok Viral Intelligence Engine — high-performance Apify actor.

- **URL**: https://apify.com/edgeofcali/tokscrape-max.md
- **Developed by:** [Edward Martinez](https://apify.com/edgeofcali) (community)
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## TokScrape Max — TikTok Viral Intelligence Engine

### Overview

TokScrape Max is a powerful Apify actor designed to extract, analyze, and monitor viral content intelligence from TikTok at scale. Whether you're a social media marketer, brand strategist, data analyst, or content creator, TokScrape Max gives you deep access to TikTok's trending videos, hashtags, user profiles, engagement metrics, and viral patterns — all delivered in clean, structured JSON. Stop guessing what's trending and start making data-driven decisions with real-time TikTok intelligence.

With TokScrape Max, you can track viral videos across niches, monitor competitor accounts, extract hashtag performance data, and identify emerging trends before they peak. The actor is built for reliability and scale, supporting bulk data extraction with robust error handling. Ideal for influencer marketing platforms, competitive intelligence tools, social listening dashboards, academic research, and content strategy pipelines.

***

### Key Features

- 🔥 **Viral Video Discovery** — Extract trending TikTok videos by hashtag, keyword, or user
- 📊 **Engagement Metrics** — Collect likes, shares, comments, play counts, and save rates
- 👤 **User Profile Scraping** — Pull follower counts, bios, video counts, and account stats
- 🏷️ **Hashtag Intelligence** — Track hashtag view counts and associated content
- 🎵 **Sound & Music Trends** — Identify trending audio used across viral videos
- 📅 **Historical & Real-Time Data** — Access both recent and older content
- 🌍 **Multi-Region Support** — Target content from specific geographic regions
- ⚡ **High-Speed Extraction** — Optimized for performance with large-scale crawls
- 🔄 **Structured JSON Output** — Ready-to-use data for dashboards, BI tools, or databases

***

### Tutorial — How to Use TokScrape Max

#### Step 1: Open the Actor

Navigate to the TokScrape Max actor page on Apify and click **"Try for free"** or **"Run"** to open the input configuration panel.

#### Step 2: Configure Your Input

Fill in the input fields to define what data you want to extract:

| Field | Description | Example Value |
|---|---|---|
| `searchQuery` | Keyword or phrase to search on TikTok | `"viral dance 2024"` |
| `hashtags` | List of hashtags to scrape | `["#fyp", "#trending", "#viral"]` |
| `usernames` | TikTok usernames to profile-scrape | `["charlidamelio", "khaby.lame"]` |
| `maxResults` | Maximum number of results to return | `100` |
| `region` | Target region/country code | `"US"` |
| `contentType` | Type of content: `videos`, `users`, `hashtags` | `"videos"` |
| `sortBy` | Sort results by: `trending`, `recent`, `popular` | `"trending"` |
| `includeMetrics` | Whether to include engagement stats | `true` |
| `proxyConfig` | Optional proxy configuration | `{ "useApifyProxy": true }` |

#### Step 3: Run the Actor

Click the **Start** button to begin the extraction. Depending on the number of results requested, the run may take a few seconds to several minutes. You can monitor progress in the **Log** tab.

#### Step 4: Access Your Data

Once the run completes, navigate to the **Dataset** tab to view, download, or export your results. Data is available in JSON, CSV, Excel, XML, and RSS formats. You can also connect results directly to Apify's integrations with Google Sheets, Zapier, Make (Integromat), and more.

#### Step 5: Schedule or Automate

Use Apify's **Scheduler** to run TokScrape Max automatically at regular intervals (hourly, daily, weekly) to keep your TikTok intelligence feed continuously updated.

***

### Sample Input

```json
{
  "searchQuery": "morning routine",
  "hashtags": ["#morningroutine", "#productivity", "#fyp"],
  "usernames": [],
  "maxResults": 50,
  "region": "US",
  "contentType": "videos",
  "sortBy": "trending",
  "includeMetrics": true,
  "proxyConfig": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

***

### Sample Output

```json
[
  {
    "videoId": "7312894561234567890",
    "url": "https://www.tiktok.com/@wellness_creator/video/7312894561234567890",
    "description": "My 5am morning routine that changed my life ☀️ #morningroutine #productivity #fyp",
    "author": {
      "username": "wellness_creator",
      "displayName": "Wellness With Sara",
      "followerCount": 1240000,
      "followingCount": 312,
      "videoCount": 487,
      "verified": false,
      "bio": "Helping you build better habits 🌿",
      "profileUrl": "https://www.tiktok.com/@wellness_creator"
    },
    "metrics": {
      "playCount": 4820000,
      "likeCount": 342000,
      "commentCount": 8900,
      "shareCount": 56700,
      "saveCount": 128000,
      "engagementRate": 11.1
    },
    "hashtags": ["morningroutine", "productivity", "fyp"],
    "music": {
      "title": "Aesthetic Morning",
      "author": "LoFi Beats",
      "usageCount": 98200
    },
    "duration": 62,
    "region": "US",
    "language": "en",
    "createdAt": "2024-03-15T06:22:10.000Z",
    "thumbnailUrl": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/thumbnail_example.jpg",
    "videoDownloadUrl": "https://v19-webapp.tiktok.com/video/tos/example_video.mp4",
    "scrapedAt": "2024-11-01T14:35:22.000Z"
  },
  {
    "videoId": "7298734512345678901",
    "url": "https://www.tiktok.com/@fitlife_daily/video/7298734512345678901",
    "description": "6am workout + cold shower routine 💪 #morningroutine #fitness #viral",
    "author": {
      "username": "fitlife_daily",
      "displayName": "FitLife Daily",
      "followerCount": 875000,
      "followingCount": 198,
      "videoCount": 211,
      "verified": true,
      "bio": "Daily fitness motivation 💪",
      "profileUrl": "https://www.tiktok.com/@fitlife_daily"
    },
    "metrics": {
      "playCount": 2100000,
      "likeCount": 189000,
      "commentCount": 4200,
      "shareCount": 31000,
      "saveCount": 87000,
      "engagementRate": 14.8
    },
    "hashtags": ["morningroutine", "fitness", "viral"],
    "music": {
      "title": "Rise Up",
      "author": "Motivational Sounds",
      "usageCount": 44500
    },
    "duration": 45,
    "region": "US",
    "language": "en",
    "createdAt": "2024-02-28T05:45:00.000Z",
    "thumbnailUrl": "https://p16-sign-va.tiktokcdn.com/obj/tos-maliva-p-0068/thumbnail_example2.jpg",
    "videoDownloadUrl": "https://v19-webapp.tiktok.com/video/tos/example_video2.mp4",
    "scrapedAt": "2024-11-01T14:35:25.000Z"
  }
]
```

***

### Pricing — Pay-Per-Event Model

TokScrape Max uses Apify's transparent **Pay-Per-Event** pricing model, meaning you only pay for what you actually use. There are no monthly minimums or hidden fees.

| Event | Cost |
|---|---|
| **Actor Start** | ~$0.03 per run |
| **Per Result Extracted** | ~$0.001 per record |

#### Pricing Examples

| Use Case | Results | Estimated Cost |
|---|---|---|
| Quick trend check | 50 videos | ~$0.08 |
| Daily hashtag monitor | 500 videos | ~$0.53 |
| Weekly competitive audit | 2,000 profiles | ~$2.03 |
| Large-scale research | 10,000 videos | ~$10.03 |

> 💡 **Tip:** Use Apify's free tier ($5 monthly credit for new users) to get started with TokScrape Max at no initial cost. Residential proxy usage may incur additional charges depending on your proxy configuration.

***

### Use Cases

#### 📈 Social Media Marketing

Identify what content formats and themes are driving virality in your niche. Use engagement rate data to benchmark your own content performance.

#### 🕵️ Competitive Intelligence

Monitor competitor TikTok accounts, track their most-viewed videos, and reverse-engineer their content strategy with real follower and engagement data.

#### 🎯 Influencer Discovery

Find rising creators before they become expensive. Filter by follower count, engagement rate, region, and niche to identify the perfect influencer partners.

#### 🔬 Academic & Market Research

Collect large datasets of TikTok content for sentiment analysis, trend forecasting, cultural studies, and social media behavior research.

#### 🛍️ E-commerce & Product Discovery

Track which products are going viral on TikTok Shop and #TikTokMadeMeBuyIt to spot high-demand products early.

#### 🎵 Music & Audio Trends

Monitor which songs and sounds are being used in viral videos — invaluable for music labels, playlist curators, and audio brand managers.

***

### Integrations

TokScrape Max output can be seamlessly connected to:

- **Google Sheets** — Live updating spreadsheets with TikTok data
- **Zapier / Make** — Automate workflows triggered by new viral content
- **Slack Notifications** — Get alerts when new trending content is detected
- **BigQuery / Snowflake** — Feed data into your analytics warehouse
- **Custom APIs** — Use Apify webhooks to push data to your own systems

***

### FAQ

**Q: Does TokScrape Max require a TikTok account or API key?**
A: No. TokScrape Max handles all authentication internally. You just configure your inputs and run.

**Q: How fresh is the data?**
A: Data is scraped in real-time at the moment you run the actor, ensuring you always get the most up-to-date information.

**Q: Can I scrape private accounts or restricted content?**
A: No. TokScrape Max only accesses publicly available TikTok content in compliance with TikTok's publicly accessible data.

**Q: What regions are supported?**
A: TokScrape Max supports global content discovery. Use the `region` field to target specific countries such as `US`, `UK`, `IN`, `BR`, and more.

**Q: Is this compliant with TikTok's terms of service?**
A: TokScrape Max is designed for scraping publicly accessible data. Users are responsible for ensuring their usage complies with applicable laws and platform policies.

***

### Support

Have a question or need a custom feature? Open an issue in the actor's GitHub repository or contact the actor author through the Apify platform. We're committed to keeping TokScrape Max up-to-date with TikTok's evolving platform.

***

*TokScrape Max is an independent tool and is not affiliated with, endorsed by, or sponsored by TikTok or ByteDance Ltd.*

# Actor input Schema

## `startUrls` (type: `array`):

URLs to scrape. Add one or more TikTok URLs. Supports lists and uploaded .txt files.

## `maxItems` (type: `integer`):

Limit the total number of results to control costs. Start with 100 to test, then scale up.

## `useMarkdown` (type: `boolean`):

Convert page HTML to clean Markdown. Uses 67% fewer tokens than raw HTML — highly recommended for LLM and RAG pipelines.

## `cleanData` (type: `boolean`):

Automatically strip tracking scripts, ads, cookie banners, and duplicate whitespace from extracted text.

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

Use Apify Proxy to avoid IP bans. Residential proxies are recommended for high-security sites like LinkedIn, Amazon, and TikTok.

## `stealthMode` (type: `boolean`):

Enable 2026 browser fingerprint randomization and human-like interaction patterns. Recommended for all protected sites.

## `maxConcurrency` (type: `integer`):

How many pages to crawl at once. Increase for speed, decrease to avoid detection.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.tiktok.com/@mrbeast"
    }
  ],
  "maxItems": 100,
  "useMarkdown": true,
  "cleanData": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "stealthMode": true,
  "maxConcurrency": 10
}
```

# Actor output Schema

## `results` (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 = {
    "startUrls": [
        {
            "url": "https://www.tiktok.com/@mrbeast"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("edgeofcali/tokscrape-max").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 = { "startUrls": [{ "url": "https://www.tiktok.com/@mrbeast" }] }

# Run the Actor and wait for it to finish
run = client.actor("edgeofcali/tokscrape-max").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 '{
  "startUrls": [
    {
      "url": "https://www.tiktok.com/@mrbeast"
    }
  ]
}' |
apify call edgeofcali/tokscrape-max --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,edgeofcali/tokscrape-max"
        }
    }
}
```

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/tus2WwbmfIErgv6EY/builds/Nv0Knw0S8DbN2fecN/openapi.json