TikTok Trends Scraper

Extract live TikTok trend and discovery data: ranked hashtags from Creative Center plus concrete videos, sounds, and creators surfaced by TikTok Explore. Metrics are included only when TikTok reports them. No TikTok account required.

What it does

TikTok Trends Scraper uses TikTok's Creative Center and public Explore feed across four categories:

• Trending Hashtags — Creative Center rankings with the requested country and period, including available video counts, view totals, and trend direction
• Explore Sounds — sounds attached to concrete Explore videos, with IDs, titles, attribution, audio metadata, and usage metrics when the source supplies them
• Explore Creators — creators attached to concrete Explore videos, with public identity fields and profile totals when the source supplies them
• Explore Videos — concrete videos in TikTok's returned Explore order, with available engagement metrics and direct URLs

countryCode configures the query and residential proxy location for every mode. Creative Center hashtag results honor its country/period filters; TikTok does not expose an equivalent public regional or period ranking API for sound, creator, or video fallback rows, so those rows must not be interpreted as formal country rankings.

Who is it for

Content creators and marketers — find trending hashtags before they peak to ride the wave of viral topics. Identify the sounds your target audience is using right now and create content that gets discovered.

Brand managers and agencies — run weekly trend monitoring across multiple countries in your pipeline. Track which hashtags competitors' audiences follow and plan campaigns around real engagement signals.

Influencer marketing teams — inspect creators currently surfaced with Explore videos and use available public identity/profile fields for further research.

Data journalists and researchers — analyze Creative Center hashtag trends and archive the live sounds, creators, and videos returned by Explore. Export structured data into existing analysis tools.

E-commerce sellers — spot product-adjacent trends early. If a hashtag related to your niche is rising, create content or ads timed with the momentum window.

Why use it

• No TikTok account needed — TikTok Creative Center is a public advertiser tool. No login, no API keys, no rate limits from your account.
• Official data source — Creative Center is TikTok's own trend intelligence platform, the same data advertisers pay to access.
• Four data categories in one actor — hashtags, sounds, creators, and videos from a single configurable run.
• Country-aware querying — 100+ proxy/query countries supported; formal country/period ranking is available for Creative Center hashtag rows, while Explore-derived modes expose TikTok's live returned order.
• Structured output — clean JSON ready for Google Sheets, BigQuery, Airtable, or custom dashboards.

Use cases

• Content strategy: Identify trending topics to create content around before they peak
• Hashtag research: Find the highest-engagement hashtags for any niche in any country
• Market research: Inspect sounds and creators attached to videos in TikTok's current Explore response
• Influencer discovery: Collect public creator identities surfaced by Explore for further qualification
• Competitor analysis: See which trends your competitors' target audience is following
• Campaign planning: Inspect sound titles and attribution; verify commercial-use eligibility separately before using audio in ads
• News and journalism: Track viral content and social media trends for reporting
• Academic research: Study viral diffusion patterns and content trends across markets

How to use it

Step 1 — Select trend type

Choose what kind of trending data you need:

Type	What you get
hashtag	Top trending hashtags with video counts and view totals
sound	Sounds attached to Explore videos, with audio metadata and available usage stats
creator	Creators attached to Explore videos, with identity and available profile totals
video	Concrete Explore videos with available engagement metrics

Step 2 — Set your location

Enter a two-letter ISO country code. It is sent to Creative Center for hashtag queries and selects the residential proxy location for fallback modes; TikTok does not guarantee regional ranking for Explore-derived rows:

• US — United States (default)
• GB — United Kingdom
• DE — Germany
• FR — France
• JP — Japan
• BR — Brazil
• IN — India
• AU — Australia
• Leave as US or try "" for broader results

Step 3 — Choose time period

Select the Creative Center hashtag trend window. The value remains in every row as requested query context, but TikTok's public Explore feed does not expose an equivalent period filter:

• 7 — Last 7 days (most current, default)
• 30 — Last 30 days (monthly trends)
• 120 — Last 120 days (quarterly trends)

Step 4 — Set max results

Set how many trending items to extract (1–100). TikTok Creative Center typically surfaces up to 100 items per category.

Input configuration

Field	Type	Default	Description
trendType	string	hashtag	Type: hashtag, sound, creator, or video
countryCode	string	US	ISO 2-letter country code
period	integer	7	Time period in days: 7, 30, or 120
maxResults	integer	30	Number of results to extract (1–100)

Example inputs

Get top 50 trending hashtags in the US (last 7 days)

{
    "trendType": "hashtag",
    "countryCode": "US",
    "period": 7,
    "maxResults": 50
}

Get up to 20 sounds surfaced by TikTok Explore from a UK-located session

{
    "trendType": "sound",
    "countryCode": "GB",
    "period": 30,
    "maxResults": 20
}

Get up to 30 creators surfaced by TikTok Explore from a Brazil-located session

{
    "trendType": "creator",
    "countryCode": "BR",
    "period": 7,
    "maxResults": 30
}

Get up to 25 videos surfaced by TikTok Explore from a Germany-located session

{
    "trendType": "video",
    "countryCode": "DE",
    "period": 30,
    "maxResults": 25
}

Output format

All results are stored in the dataset. Each item includes common fields plus type-specific fields.

Common fields (all types)

Field	Type	Description
rank	number	Position in this run's source order; a formal trend rank only for Creative Center results
type	string	Trend type: hashtag, sound, creator, or video
name	string	Name/title of the trending item
countryCode	string	Country code used for the query
period	number	Time period in days
scrapedAt	string	ISO timestamp when data was scraped

Hashtag output example

{
    "rank": 1,
    "type": "hashtag",
    "name": "#fyp",
    "publishedVideoCount": 48200000,
    "videoViews": 12800000000,
    "trend": "rising",
    "trendingVideoUrls": [
        "https://www.tiktok.com/@username/video/1234567890"
    ],
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Sound output example

{
    "rank": 1,
    "type": "sound",
    "name": "Espresso",
    "soundId": "7362164559887052574",
    "soundAuthor": "Sabrina Carpenter",
    "soundCover": "https://p16-sign-va.tiktokcdn.com/...",
    "soundPlayUrl": "https://sf16-ies-music.tiktokcdn.com/...",
    "duration": 179,
    "isOriginal": false,
    "linkedVideoUrl": "https://www.tiktok.com/music/x-7362164559887052574",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Creator output example

{
    "rank": 1,
    "type": "creator",
    "name": "Creator Name",
    "creatorId": "6784563861129756673",
    "creatorHandle": "@username",
    "creatorAvatarUrl": "https://p16-sign-va.tiktokcdn.com/...",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Video output example

{
    "rank": 1,
    "type": "video",
    "name": "Check out this incredible moment...",
    "videoId": "7318423157234567890",
    "videoUrl": "https://www.tiktok.com/@username/video/7318423157234567890",
    "videoCoverUrl": "https://p16-sign-va.tiktokcdn.com/...",
    "videoDesc": "Check out this incredible moment #viral #trending",
    "playCount": 45200000,
    "likeCountVideo": 3800000,
    "commentCount": 124000,
    "shareCount": 892000,
    "authorHandle": "@username",
    "authorName": "Creator Name",
    "hashtags": ["#viral", "#trending"],
    "soundName": "Original Sound",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Trend direction

The trend field indicates momentum based on the trend chart data provided by TikTok Creative Center:

Value	Meaning
rising	Last data point > first data point by 10%+
falling	Last data point < first data point by 10%+
stable	Change within ±10%

Countries supported

TikTok Creative Center supports 100+ countries. Common country codes:

Region	Code	Region	Code
United States	US	Japan	JP
United Kingdom	GB	South Korea	KR
Germany	DE	Brazil	BR
France	FR	Mexico	MX
Italy	IT	Argentina	AR
Spain	ES	Australia	AU
Netherlands	NL	Canada	CA
India	IN	Indonesia	ID
Thailand	TH	Philippines	PH
Vietnam	VN	Saudi Arabia	SA

Pricing

This actor uses pay-per-event (PPE) pricing — you only pay for results you actually get.

Event	Price
Actor start	$0.05 (one-time per run)
Per trend item scraped	$0.015 (FREE tier)

Tiered discounts — the more you use the platform, the less you pay per result:

Tier	Price per item
FREE	$0.0150
BRONZE	$0.0135
SILVER	$0.0105
GOLD	$0.0082
PLATINUM	$0.0054
DIAMOND	$0.0038

Cost examples

Use case	Items	Cost (FREE tier)
Quick trend check	20 items	~$0.35
Daily monitoring	50 items	~$0.80
Full category scan	100 items	~$1.55
4-category full scan	400 items	~$6.05

All prices in USD. Costs decrease at higher subscription tiers.

Technical notes

How it works

The actor uses TikTok's current public Creative Center surface plus a browser fallback:

1. Hashtag runs call Creative Center's current GetHashtagList route with the requested country, period, and pagination.
2. Other modes, or a failed current API call, establish a country-located browser session and inspect TikTok's live public Explore responses.
3. Only concrete Creative Center records or concrete public TikTok videos and their derived entities are normalized into output. Explore output order is preserved but is not advertised as a regional trend ranking.
4. Metrics omitted by TikTok stay absent; they are never converted into factual zeroes. If every live route returns no concrete items, the run fails instead of returning synthetic discovery keywords or placeholder metrics.

This approach works because TikTok Creative Center is a public-facing tool for advertisers — no login is required.

Performance

• Typical run time: 30–90 seconds per run
• Memory: 1024 MB (configured for Playwright with residential proxy)
• Residential proxies used automatically for reliability

Limitations

• Maximum 100 results per category (TikTok Creative Center limit); higher requests are capped and logged
• TikTok's current public Creative Center surface exposes a country/period hashtag ranking, but no equivalent public sound, creator, or Explore-video ranking route. Those modes return concrete entities from TikTok Explore in source order; countryCode selects the browser location and period is request context, not a regional/time-window ranking guarantee.
• Sound usage totals and creator profile totals are omitted when Explore does not embed them. An absent metric is not a measured zero.
• Creative Center trend data may differ slightly from TikTok's main app, and Explore contents can vary by session.
• Real-time data: each run fetches the latest data at time of execution

FAQ

Do I need a TikTok account? No. TikTok Creative Center is publicly accessible — no login required.

How fresh is the data? Data is fetched live at the time of each run. TikTok updates Creative Center trend data daily.

Can I monitor trends over time? Yes. Schedule the actor to run daily and save results to a dataset or spreadsheet integration. Use Apify's scheduling and Google Sheets integration for automated monitoring.

What's the difference between period 7, 30, and 120? Creative Center uses these windows for hashtag rankings. TikTok's public Explore response does not expose a matching period filter for video, sound, or creator fallback rows, so those modes retain the requested value as context only.

Where do video results come from? Video rows come only from concrete Creative Center top-content or public TikTok video records. If TikTok exposes neither route to the run, the actor fails rather than substituting hashtag or discovery rows.

What proxy type is used? Residential proxies are used automatically to ensure the Creative Center loads correctly and serves real trend data.

Why can a run fail with no items? TikTok can block both Creative Center and public fallback requests. In that case the actor exits with a non-zero failure and no charged result rows, rather than reporting placeholder data as trends. A retry may obtain a different live session; persistent failures can indicate that TikTok no longer exposes that mode publicly.

Is the data different from TikTok's main app trending page? Yes, slightly. Creative Center data is aggregated for advertiser use and may lag the main app by a few hours. It covers broader trends across the full platform rather than your personalized feed.

Integrations

Connect TikTok trend data to your existing workflows:

• Google Sheets — Schedule daily hashtag monitoring runs and auto-export results to a Google Sheet for your content team using Apify's Google Sheets integration
• Slack alerts — Trigger a Slack notification when a tracked hashtag crosses a view threshold using Apify webhooks + Zapier
• Airtable content calendar — Push trending hashtags and sounds directly into an Airtable content planning database as new records
• BigQuery / data warehouse — Export runs to BigQuery for longitudinal trend analysis across weeks or months
• Make (Integromat) — Chain scraper output into downstream content scheduling tools or CRM enrichment workflows
• Custom dashboards — Use the Apify API to pull results into Grafana, Metabase, or Looker Studio for real-time trend monitoring

API usage

You can trigger runs and fetch results programmatically using the Apify API.

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('automation-lab/tiktok-trends-scraper').call({
    trendType: 'hashtag',
    countryCode: 'US',
    period: 7,
    maxResults: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log('Trending hashtags:', items);

Python

from apify_client import ApifyClient

client = ApifyClient('YOUR_API_TOKEN')

run = client.actor('automation-lab/tiktok-trends-scraper').call(run_input={
    'trendType': 'hashtag',
    'countryCode': 'US',
    'period': 7,
    'maxResults': 50,
})

items = client.dataset(run['defaultDatasetId']).list_items().items
print('Trending hashtags:', items)

cURL

curl -X POST "https://api.apify.com/v2/acts/automation-lab~tiktok-trends-scraper/runs?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"trendType":"hashtag","countryCode":"US","period":7,"maxResults":50}'

Then fetch results:

$curl "https://api.apify.com/v2/datasets/DATASET_ID/items?token=YOUR_API_TOKEN"

Use with AI assistants (MCP)

You can use TikTok Trends Scraper directly from Claude, Cursor, VS Code, or any MCP-compatible AI assistant.

Claude Code

$claude mcp add --transport http tiktok-trends "https://mcp.apify.com?tools=automation-lab/tiktok-trends-scraper&token=YOUR_API_TOKEN"

Claude Desktop / Cursor / VS Code

Add to your MCP settings JSON:

{
  "mcpServers": {
    "tiktok-trends": {
      "url": "https://mcp.apify.com?tools=automation-lab/tiktok-trends-scraper&token=YOUR_API_TOKEN"
    }
  }
}

Example prompts

• "What are the top 20 trending hashtags in the US right now?"
• "Collect sounds attached to videos surfaced by TikTok Explore from a South Korea-located session"
• "Collect creator identities surfaced by TikTok Explore from a Brazil-located session"

Legality

Yes. TikTok Creative Center is a publicly accessible platform — no authentication is required to view trend data. This actor accesses only public pages intended for advertisers and marketers. No personal user data is collected or processed. The actor does not circumvent paywalls or access private content.

Always review TikTok's terms of service and applicable laws in your jurisdiction before use. This actor is intended for research, marketing analysis, and business intelligence purposes.

Related scrapers

• TikTok Scraper — Scrape TikTok profiles, videos, comments, and search results
• TikTok Comments Scraper — Extract comments from TikTok videos with author info and engagement metrics
• Instagram Trends Scraper — Track trending hashtags and content on Instagram

Support

For questions or issues, please use the actor's GitHub Issues page or contact the developer through Apify's support channels.

Use with AI agents via x402 (no Apify account)

Agent workflows can run this actor through Apify MCP without an Apify account when the MCP client uses a funded x402 wallet. Use the actor-specific MCP endpoint:

https://mcp.apify.com?tools=automation-lab/tiktok-trends-scraper&payment=x402

This keeps existing Apify MCP/API usage unchanged; x402 only changes payment/authentication for clients that support it. Learn more in Apify's x402 integration docs.