# TikTok Trending Videos Scraper — Viral Videos & Creator Data (`rastriq/tiktok-trending-videos-scraper`) Actor

Extract trending videos from TikTok Creative Center with creator profiles, engagement rates, organic views, and 6-second view-through rates. Filter by country and category. Export to JSON, CSV, or Excel.

- **URL**: https://apify.com/rastriq/tiktok-trending-videos-scraper.md
- **Developed by:** [Rastriq — Structured data from the world](https://apify.com/rastriq) (community)
- **Categories:** Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 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.

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

## 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

## TikTok Trending Videos Scraper — Top Performing Videos from TikTok Creative Center

![tiktok trending videos](https://www.rastriq.es/readme/intel.png)

Extract trending videos from TikTok Creative Center with creator profiles, engagement metrics, and view-through rates. TikTok Trending Videos Scraper gives you the data behind viral content — who made it, how it performed, and why it's trending — in JSON, CSV, or Excel.

> Try it free — your first $5 of usage is on Apify. No credit card required.

### What is TikTok Trending Videos Scraper?

**TikTok Trending Videos Scraper** extracts the top-performing videos from TikTok's Creative Center — the official analytics hub where advertisers and brands discover what's working on the platform. Instead of scrolling through the dashboard manually, this scraper delivers structured data on every trending video, including engagement metrics that aren't available through TikTok's public API.

Use TikTok Trending Videos Scraper to:

- **Discover winning content formats** — see what videos are going viral right now and analyze the patterns behind them
- **Find influencers** — get creator profiles with follower counts, bios, and performance data for partnership decisions
- **Benchmark engagement** — compare engagement rates, organic views, and 6-second view-through rates across categories
- **Automate competitive intelligence** — schedule daily runs and get fresh data delivered to your pipeline without manual work

### What data does TikTok Trending Videos Scraper extract?

Each video result includes both content metadata and performance metrics:

|                          |                                    |
| ------------------------ | ---------------------------------- |
| Video title and TikTok URL | Cover image and video download URL |
| Creator handle and name  | Creator followers and bio          |
| Total video views        | Organic views (non-promoted)       |
| Engagement rate (%)      | 6-second view-through rate (%)     |
| Lifetime views and engagement | Category and country            |
| Creation date            | Extraction timestamp               |

### How to use TikTok Trending Videos Scraper

Getting trending TikTok video data takes under a minute:

1. **Create a free Apify account** at [apify.com](https://apify.com) — your first $5 is free
2. **Open TikTok Trending Videos Scraper** in the Apify Console or click **Try for free** on this page
3. **Select your countries** — choose from US, Japan, Vietnam, Thailand, or Indonesia
4. **Pick a category** (optional) — Beauty, Fashion, Food, Lifestyle, or Technology
5. **Set your time period** — 7, 30, or 120 days
6. **Click Start** and get results in seconds
7. **Download your data** in JSON, CSV, Excel, or XML — or access it via the Apify API

### Input parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `countries` | array | Yes | `["US"]` | Countries to scrape: `US`, `JP`, `VN`, `TH`, `ID` |
| `category` | string | No | All | Content category: Beauty & Care, Fashion, Food & Beverage, Lifestyle & Leisure, or Technology & Finance |
| `period` | string | Yes | `"7"` | Time window: `"7"`, `"30"`, or `"120"` days |
| `maxItems` | integer | No | `100` | Maximum videos per country/category combination (1–100) |

**Example input:**

```json
{
  "countries": ["US", "JP"],
  "category": "Beauty & Care",
  "period": "30",
  "maxItems": 50
}
```

### Output example

Each result is a structured JSON object with rich performance data. Here's a sample from a real run:

```json
{
  "type": "video",
  "country": "US",
  "period_days": 7,
  "category": "",
  "title": "When my boyfriend coughs. Tag your partner if you can relate. #galaxyzfold8ultra #samsungpartner",
  "tiktok_url": "https://www.tiktok.com/video/7665337718389345567",
  "cover_url": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osCfE7FnALVpvvPgEADAIAYuROqAwCBEAMEwfb~tplv-tiktokx-origin.image",
  "video_url": "https://v16m-default.tiktokcdn-us.com/a402510a44419f32281024118a41c6f1/...",
  "created_at": "2026-07-22T13:05:46+00:00",
  "creator_handle": "hannahstocking",
  "creator_name": "Hannah Stocking",
  "creator_followers": 29538563,
  "video_views": 116968898,
  "organic_views": 20238585,
  "engagement_rate": 0.8851,
  "six_second_vtr": 39.5342,
  "video_views_lifetime": 124632666,
  "organic_views_lifetime": 27902353,
  "engagement_rate_lifetime": 1.3686,
  "six_second_vtr_lifetime": 42.119,
  "scraped_at": "2026-08-29T19:50:04.285569+00:00"
}
```

```json
{
  "type": "video",
  "country": "US",
  "period_days": 7,
  "category": "Technology & Finance",
  "title": "Designed to match your vibe. Because your style doesn't stop at your outfit. #GalaxyZFlip8 #SamsungPartner",
  "tiktok_url": "https://www.tiktok.com/video/7665338027799104781",
  "created_at": "2026-07-22T13:06:47+00:00",
  "creator_handle": "thepacman82",
  "creator_name": "Phil Cohen",
  "creator_followers": 354877,
  "video_views": 28058911,
  "organic_views": 1047089,
  "engagement_rate": 0.2619,
  "six_second_vtr": 21.8088,
  "video_views_lifetime": 182863632,
  "organic_views_lifetime": 15094783,
  "engagement_rate_lifetime": 0.3004,
  "six_second_vtr_lifetime": 22.7356,
  "scraped_at": "2026-08-29T19:50:04.285614+00:00"
}
```

Download results in **JSON, CSV, Excel, XML, or HTML** from the Output tab, or pull them programmatically using the Apify API.

> **GDPR note** — Creator personal information (handle is kept) (`creator_name, creator_bio, creator_avatar_url`) are replaced with `"GDPR Protection"` in the public sample dataset. The live Actor returns full values — your data, your responsibility.

### See real records before you run it

[Browse sample data](https://console.apify.com/storage/datasets/P4OMnEfYmwp6C5xB2) extracted by this Actor — fields, format and structure, ready to inspect before your first run.

### How much does it cost to use TikTok Trending Videos Scraper?

**$1.00 per 1,000 videos** (+ $0.025 per start). Your $5 free trial credit covers ~4,900 videos.

### 🔗 Related Rastriq Actors

#### TikTok Creative Center

| Actor | What it adds |
| --- | --- |
| [TikTok Top Ads Scraper](https://apify.com/rastriq/tiktok-top-ads-scraper) | Top-performing ad creatives — CTR, likes, video URLs, landing pages across 49 countries and 21 industries |
| [TikTok Trends Scraper](https://apify.com/rastriq/tiktok-trends-scraper) | Trending hashtags with view counts, post volumes and industry tags across 27 countries |

#### Ad library scrapers

Extract the actual ads running on each platform — all four share a [normalized output schema](https://www.rastriq.es/en/ad-libraries/).

| Actor | What it adds |
| --- | --- |
| [TikTok Ad Library Scraper](https://apify.com/rastriq/tiktok-ad-library-scraper) | Real ads from TikTok's EU transparency archive — creatives, targeting, spend and audience data |
| [Facebook Ad Library Scraper](https://apify.com/rastriq/fb-adlibrary-scraper) | Ad creatives from Facebook and Instagram |
| [Google Ads Transparency Scraper](https://apify.com/rastriq/google-ads-scraper) | Search, Display and YouTube ads from Google's Ads Transparency Center |
| [LinkedIn Ad Library Scraper](https://apify.com/rastriq/linkedin-ad-library-scraper) | B2B ad intelligence — impressions by country, paying entity and targeting |

#### Competitive intelligence

| Actor | What it adds |
| --- | --- |
| [SimilarWeb Data Extractor](https://apify.com/rastriq/similarweb-data-extractor) | Traffic estimates and top pages for the landing pages these ads point to |

### Copy to your AI assistant

Copy the Apify Store URL for this Actor and paste it into ChatGPT, Claude, or any LLM with web access:

```
https://apify.com/rastriq/tiktok-trending-videos-scraper
```

The model will read the Actor description, input schema, and field list — then help you build the right API call or integration.

### About the data

This Actor is built and maintained by [Rastriq](https://www.rastriq.es), a data intelligence company specializing in structured extraction for market research and competitive analysis. Browse our full [field reference and methodology](https://www.rastriq.es/en/competitive-intelligence/#campos).

### Frequently Asked Questions

#### Is scraping TikTok trending videos legal?

TikTok Trending Videos Scraper only accesses **publicly available data** from TikTok's Creative Center — information visible to any visitor without logging in. We apply reasonable rate limiting to avoid overloading their servers.

As with any data collection activity, you are responsible for ensuring your use case complies with applicable laws (GDPR, CCPA) and TikTok's Terms of Service. For guidance, see [Apify's blog on the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/).

#### Does TikTok Trending Videos Scraper require a TikTok account?

No. TikTok Trending Videos Scraper works entirely with **public data** and does not require any account, login, or API credentials.

#### Which countries are supported?

TikTok Trending Videos Scraper currently supports 5 markets: United States, Japan, Vietnam, Thailand, and Indonesia. These are the countries available in TikTok Creative Center's trending videos section.

#### What metrics are included for each video?

Every video comes with both period-specific and lifetime metrics: total views, organic views (non-promoted), engagement rate, and 6-second view-through rate. You also get creator profile data including follower count.

#### How do I integrate TikTok Trending Videos Scraper with my workflow?

TikTok Trending Videos Scraper integrates natively with:

- **Make (formerly Integromat)** and **Zapier** — trigger runs and receive data automatically
- **Google Sheets** — export directly to a spreadsheet
- **Webhooks** — get notified when a run finishes
- **Apify API** — call from Python, Node.js, or any language (see the API tab)

#### I found a bug or my run failed. Where do I report it?

Please open an issue in the **Issues tab** on this page. Include your input configuration and the run ID so we can investigate quickly.

# Actor input Schema

## `countries` (type: `array`):

Countries to scrape trending videos for (5 available).

## `category` (type: `string`):

Filter by category. Leave empty for all.

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

Time window for trend analysis.

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

Maximum videos per country/category (up to 100).

## Actor input object example

```json
{
  "countries": [
    "US"
  ],
  "category": "",
  "period": "7",
  "maxItems": 100
}
```

# Actor output Schema

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

Trending videos from TikTok Creative Center

# 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 = {
    "countries": [
        "US"
    ],
    "period": "7",
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("rastriq/tiktok-trending-videos-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 = {
    "countries": ["US"],
    "period": "7",
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("rastriq/tiktok-trending-videos-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 '{
  "countries": [
    "US"
  ],
  "period": "7",
  "maxItems": 100
}' |
apify call rastriq/tiktok-trending-videos-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rastriq/tiktok-trending-videos-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/iwAyRy4uXcVdpNCbK/builds/RpwgtzKahdbgCorbN/openapi.json
