TikTok Trends Scraper

Extract live TikTok trends: hashtags from Creative Center by country, period and industry, TikTok's ranked top videos, and videos, sounds and creators from TikTok Explore. Each hashtag comes with its popularity curve and trend stage. Metrics are included only when TikTok reports them. No TikTok account, cookies or API key.

What it does

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

• Trending Hashtags — Creative Center lists for the requested country and period, with post and view counts, popularity curve, trend stage, industries and top creators
• Trending Videos — either live Explore videos with likes, comments, shares and saves, or TikTok's ranked Creative Center top videos with views, engagement rate and 6-second view rate
• Explore Sounds — sounds used by concrete Explore videos, with IDs, titles, artists, audio URLs, duration, and original-sound and commercial-use flags
• Explore Creators — creators of concrete Explore videos, with handles, profile links, follower, like and video totals, bios and verified status

countryCode sets the query for Creative Center rows and the browser location for Explore rows. TikTok has no public regional or period ranking for sounds and creators, and none for Explore videos, so those rows are not formal country rankings.

How many results you get

TikTok shows short lists to logged-out visitors: 3 hashtags or 4 videos per Creative Center list, whatever limit is asked, with no second page. This Actor reads every list for your country and period and merges them, so you get far more than one list shows:

Mode	Lists read	Usual result
hashtag	The overall list and 15 industry lists	About 45 distinct hashtags per country and period
video, Creative Center	Every sort, content tag and organic switch	Up to 100 videos in the US; a smaller list can return fewer
video, sound, creator from Explore	Live Explore category feeds	Usually up to 100; TikTok sometimes limits one session

Asking for 100 hashtags returns about 45, because that is all TikTok shows. You only pay for the rows you get, and the run's final status says how many you got and why.

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 — no login, cookies or API keys.
• Official data source — Creative Center is TikTok's own trend tool for advertisers.
• Four data categories in one Actor — hashtags, videos, sounds and creators from a single configurable run.
• More than one list shows — lists are merged past TikTok's logged-out limit, and each row says which list it came from.
• Trend signals included — every Creative Center hashtag has a daily popularity curve, a trend stage (rising, peaking, steady, declining), momentum and peak date.
• Clear about where a row comes from — source, rankingScope and isFormalRanking separate TikTok's own ranks from merged lists and Explore 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	Trending hashtags with post and view counts, popularity curve, trend stage and top creators
sound	Sounds used by Explore videos, with audio metadata and commercial-use flag
creator	Creators of Explore videos, with profile links and follower, like and video totals
video	Explore videos with engagement metrics, or Creative Center top videos with videoSource: "creativeCenter"

Step 2 — Set your location

Enter a two-letter ISO country code. It is sent to Creative Center for ranked rows and selects the browser location for Explore rows; TikTok does not guarantee regional ranking for Explore rows:

• US — United States (default)
• GB — United Kingdom
• DE — Germany
• FR — France
• JP — Japan
• BR — Brazil
• SG — Singapore
• AU — Australia

If you omit countryCode, the Actor uses US. An explicit value must be a two-letter code; an empty string or a malformed value is rejected. TikTok does not operate in Hong Kong (HK), mainland China (CN) or India (IN), so those codes are rejected before the run starts.

Creative Center hashtag lists cover 27 markets: US, GB, DE, FR, IT, ES, BR, MX, CA, AU, JP, KR, ID, TH, VN, SG, MY, PH, TW, TR, SA, AE, EG, ZA, IL, AR and CO. In other countries hashtag rows are derived from Explore and marked source: "tiktok_explore". Creative Center top videos cover US, JP, VN, TH and ID.

Step 3 — Choose time period

Select the Creative Center trend window. Explore rows keep the value as context only, because TikTok's public Explore feed has no period filter:

• 7 — Last 7 days (most current, default)
• 30 — Last 30 days (monthly trends)
• 90 — Last 90 days (quarterly trends, hashtags only)

Creative Center serves only these windows, so another value uses the closest one and the row's period shows the window used. For example, 120 returns the 90-day hashtag list.

Step 4 — Set max results

Set how many items to extract (1–100). See How many results you get for what each mode usually returns.

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 90
maxResults	integer	30	Number of results to extract (1–100)
industry	string		Hashtags only. Read one industry's list, for example Games. Returns up to 3 rows
videoSource	string	explore	Videos only. explore or creativeCenter (ranked; US, JP, VN, TH, ID)
videoSortBy	string	views	Creative Center videos: rows are sorted by views, engagement or sixSecondViews, highest first, across the lists read. With organicOnly, views means organic views
organicOnly	boolean	false	Creative Center videos: leave out rankings that include paid views

Example inputs

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

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

Get TikTok's top videos by engagement in the US (last 30 days)

{
    "trendType": "video",
    "videoSource": "creativeCenter",
    "videoSortBy": "engagement",
    "countryCode": "US",
    "period": 30,
    "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. Ranking provenance is explicit, so pipelines can distinguish a formal Creative Center rank from TikTok Explore's returned source order without parsing prose.

Common fields (all types)

Field	Type	Description
rank	number	Position in this run's output; check the provenance fields before interpreting it
source	string	tiktok_creative_center or tiktok_explore
rankingScope	string	country_period when rank is TikTok's own overall rank, country_period_list for a row merged in from another list or moved by the chosen sort, or source_order for Explore discovery order
isFormalRanking	boolean	true only when rank is TikTok's own overall rank for this country and period
listRank	number	Creative Center rows: the rank inside the list the row came from
listSort	string	Creative Center videos: the TikTok ranking listRank refers to: views, engagement, sixSecondViews or organicViews
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": 4,
    "source": "tiktok_creative_center",
    "rankingScope": "country_period_list",
    "isFormalRanking": false,
    "type": "hashtag",
    "name": "#costume",
    "hashtagId": "1590478",
    "hashtagUrl": "https://www.tiktok.com/tag/costume",
    "publishedVideoCount": 48200,
    "videoViews": 128000000,
    "trend": "rising",
    "trendStage": "declining",
    "momentumPct": -36,
    "peakDate": "2026-11-01",
    "popularityCurve": [
        { "date": "2026-10-31", "value": 88.5 },
        { "date": "2026-11-01", "value": 100 }
    ],
    "industries": ["Apparel & Accessories"],
    "topCreators": [
        { "handle": "@username", "nickname": "Name", "followers": 335212, "profileUrl": "https://www.tiktok.com/@username" }
    ],
    "listRank": 1,
    "listIndustry": "Apparel & Accessories",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2026-11-05T10:30:00.000Z"
}

Sound output example

{
    "rank": 1,
    "source": "tiktok_explore",
    "rankingScope": "source_order",
    "isFormalRanking": false,
    "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,
    "isCommercial": false,
    "videosInSample": 2,
    "exampleVideoUrl": "https://www.tiktok.com/@username/video/1234567890",
    "linkedVideoUrl": "https://www.tiktok.com/music/x-7362164559887052574",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Creator output example

{
    "rank": 1,
    "source": "tiktok_explore",
    "rankingScope": "source_order",
    "isFormalRanking": false,
    "type": "creator",
    "name": "Creator Name",
    "creatorId": "6784563861129756673",
    "creatorHandle": "@username",
    "creatorUrl": "https://www.tiktok.com/@username",
    "creatorAvatarUrl": "https://p16-sign-va.tiktokcdn.com/...",
    "creatorBio": "Food and travel",
    "isVerified": false,
    "followerCount": 10500,
    "likeCount": 1100000,
    "videoCount": 20,
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Video output example

{
    "rank": 1,
    "source": "tiktok_explore",
    "rankingScope": "source_order",
    "isFormalRanking": false,
    "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,
    "collectCount": 55500,
    "durationSeconds": 32,
    "videoCreatedAt": "2026-10-30T12:00:00.000Z",
    "isAd": false,
    "authorHandle": "@username",
    "authorName": "Creator Name",
    "authorFollowerCount": 10500,
    "hashtags": ["#viral", "#trending"],
    "soundName": "Original Sound",
    "soundId": "7362164559887052574",
    "soundAuthor": "Artist",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2025-01-15T10:30:00.000Z"
}

Creative Center video output example

Creative Center gives views and rates rather than likes, comments and shares. Use the Explore source when you need those counts.

{
    "rank": 1,
    "source": "tiktok_creative_center",
    "rankingScope": "country_period",
    "isFormalRanking": true,
    "type": "video",
    "name": "Five years ago, I started my small business...",
    "videoId": "7678479724896587038",
    "videoUrl": "https://www.tiktok.com/@username/video/7678479724896587038",
    "playCount": 41212245,
    "organicViews": 4541439,
    "lifetimeViews": 77327373,
    "engagementRate": 0.0014,
    "sixSecondViewRate": 0.0295,
    "videoCreatedAt": "2026-08-26T23:03:07.000Z",
    "authorHandle": "@username",
    "authorName": "Creator Name",
    "authorFollowerCount": 254992,
    "hashtags": ["#ad"],
    "listRank": 1,
    "listSort": "views",
    "countryCode": "US",
    "period": 7,
    "scrapedAt": "2026-11-05T10: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%

trend compares only the first and last days. For where a hashtag is now, use trendStage:

Value	Meaning
rising	Peak is today and the curve is climbing
peaking	Peak was yesterday and the curve is still up
steady	No clear move in the latest days
declining	Well below its peak, or falling over the latest days

The curve runs from 0 to 100, where 100 is the most popular day in the period. It shows the shape of a trend, not a number of views.

Countries supported

Creative Center hashtag lists cover these 27 markets. Explore modes accept any two-letter code where TikTok operates, and hashtag rows elsewhere are derived from Explore.

Region	Code	Region	Code	Region	Code
United States	US	Japan	JP	Argentina	AR
United Kingdom	GB	South Korea	KR	Colombia	CO
Germany	DE	Brazil	BR	Egypt	EG
France	FR	Mexico	MX	Israel	IL
Italy	IT	Australia	AU	Malaysia	MY
Spain	ES	Canada	CA	South Africa	ZA
Singapore	SG	Indonesia	ID	Taiwan	TW
Thailand	TH	Philippines	PH	Turkey	TR
Vietnam	VN	Saudi Arabia	SA	United Arab Emirates	AE

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.

New prices from 2026-11-21

From 2026-11-21 the price will be lower for most plans, and runs that use Creative Center will have no start fee:

Row type	FREE	BRONZE	SILVER	GOLD, PLATINUM, DIAMOND	Start fee
Creative Center rows (hashtags, ranked videos)	$0.002	$0.002	$0.0018	$0.0016	None
Explore rows (sounds, creators, Explore videos, hashtags derived from Explore)	$0.0062	$0.0062	$0.00558	$0.00496	$0.05

On DIAMOND, Explore rows rise from $0.0038 to $0.00496, and on every plan the Creative Center price is lower than today. A 30-row Creative Center run on BRONZE will cost $0.06; a 30-row Explore run will cost $0.236.

Technical notes

How it works

The Actor uses TikTok's public Creative Center and Explore surfaces:

1. Hashtag runs, and video runs with videoSource: "creativeCenter", read Creative Center's lists over plain HTTP and merge them until maxResults is met. No browser or proxy.
2. Other modes, or hashtag runs where Creative Center has no list, open a country-located browser session and read TikTok's live Explore feeds.
3. Only concrete records are normalized into output. Every row includes source, rankingScope and isFormalRanking.
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.
5. The run's final status says how many results you got against your limit and why it stopped.

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

Data handling and third parties

• The Actor sends the requested country/period context and ordinary browser request metadata to TikTok's public Creative Center or Explore surfaces. TikTok controls its own processing region and request retention.
• Outputs can include public video URLs, creator handles/names, sound attribution, hashtags, and public engagement metrics. The Actor accepts no TikTok login, password, cookie, or private-content URL.
• Input, logs, debug capture, and dataset rows use the run's default Apify storage and follow your Apify plan and deletion settings. The Actor keeps no separate cross-run copy or profile cache.
• Runtime logs contain mode, country, counts, route stages, and error classes; they do not intentionally log cookies, access tokens, or extracted profile records.
• The Actor itself does not call an AI model or send input/output to an AI provider. The optional MCP integration only lets your own external AI client invoke the Actor.

TikTok is a third-party source and is not affiliated with, endorsing, sponsoring, or operating this Actor. TikTok names and marks are used only to identify the public data source.

Performance

• Typical run time: under 15 seconds for Creative Center runs, 30–90 seconds for Explore runs
• Memory: 2048 MB (configured for Playwright with residential proxy)
• Residential proxies used automatically for Explore runs

Limitations

• Maximum 100 results per run; higher requests are capped and logged.
• Logged-out Creative Center serves 3 hashtags or 4 videos per list. Rows beyond TikTok's overall list come from filtered lists, so their rank is a position in this run, not a TikTok rank. Their listRank is the rank in their own list. Creative Center videos are sorted across lists by the chosen metric, so isFormalRanking is true only where rank still matches TikTok's overall rank.
• TikTok removed sound and creator rankings from public Creative Center. Those modes return concrete entities from TikTok Explore in source order; countryCode selects the browser location and period is request context, not a regional or time-window ranking.
• Explore gives no platform-wide usage total for a sound. videosInSample counts videos in this run only. An absent metric is not a measured zero.
• Explore feeds vary by session, and TikTok can limit one session to a few items. The final status says when a run returned fewer than you asked for.
• 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
• Country coverage: TikTok is not available in Hong Kong, mainland China or India, and Creative Center publishes no hashtag ranking there. Those country codes are rejected instead of running and failing.
• Run timeout: sound, creator and video modes open a browser session and usually need 30–120 seconds. Keep the default 300-second timeout; runs given only a few seconds time out before the first page loads.

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.

Why did I get about 45 hashtags when I asked for 100? TikTok shows 3 hashtags per list to logged-out visitors. The Actor reads the overall list and all 15 industry lists and removes duplicates, which gives about 45 for a country and period. Run other countries or periods for more. You only pay for the rows you get.

What's the difference between period 7, 30, and 90? Creative Center serves 7, 30 and 90 days for hashtags, and 7 and 30 for videos. TikTok's public Explore response has no period filter, so video, sound and creator rows from Explore keep the requested value as context only.

Where do video results come from? By default they are live public TikTok Explore records in returned order, marked source=tiktok_explore, rankingScope=source_order and isFormalRanking=false. With videoSource: "creativeCenter" they are TikTok's ranked top videos for the US, Japan, Vietnam, Thailand or Indonesia, without likes, comments and shares. If no concrete records are available, the run fails rather than substituting other rows.

What proxy type is used? Creative Center requests use direct HTTP. Explore modes use a country-located residential browser session with heavy page assets blocked and bounded retries for reliable public-data access.

Why can a run fail with no items? TikTok can block both Creative Center and public Explore 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. It covers trends across the 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

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. Output may include public creator identifiers and other public profile/video metadata, but the Actor does not access private content or accept TikTok credentials.

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
• TikTok Creative Center Scraper — Extract TikTok Creative Center Top Ads and hashtag trends

Diagnostic privacy

Failed operations send sanitized diagnostic input, exceptions, and Actor/build/run IDs to our private GlitchTip service for repair. Secret fields and URL query strings are removed; reports are retained for 30 days.

Support

For questions or issues, use the Issues tab on this Actor's page in Apify Console.

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.

Server API: get TikTok Creative Center trends over HTTP

TikTok Trends Scraper is also a Server Actor. Besides normal runs, it answers short HTTP requests directly, without starting a run for each lookup. Copy the server URL from the Actor's Server tab (do not build it from the Actor name) and authenticate with your Apify token. The server reads TikTok Creative Center only. Use normal Actor runs for Explore sounds, creators and Explore videos (they need a browser), for hashtags in countries Creative Center does not rank, and for up to 100 rows.

curl -sS "$SERVER_URL/hashtags?country=US&period=7&maxResults=20" -H "Authorization: Bearer $APIFY_TOKEN"
curl -sS "$SERVER_URL/videos?country=US&period=7&sort=views&maxResults=10" -H "Authorization: Bearer $APIFY_TOKEN"

Method and path	Input	Output and charge
GET /	None	ready: true, the routes and limits; no scraping or charge
GET /hashtags	Optional query country (two letters, default US; CN, HK and IN are rejected), period (7, 30 or 90 days; default 7), maxResults 1–50 (default 20), industry (one of the input's hashtag industries, such as Travel; case-insensitive)	{ok,count,results} with Creative Center's trending hashtags, the overall list first and then the industry lists, the same records as a normal hashtag-mode dataset item. About 45 hashtags are available per country and period; one industry gives up to 3. One result event per returned hashtag; no start fee
GET /videos	Optional query country (US, JP, VN, TH or ID; default US), period (7 or 30 days; default 7), maxResults 1–50 (default 20), sort (views, engagement or sixSecondViews; default views), organicOnly (true or false; default false)	{ok,count,results} with Creative Center's ranked videos sorted by the chosen metric, the same records as a normal video-mode dataset item with the Creative Center source. One result event per returned video; no start fee

The result event is Creative Center result (creative-center-result) once that price is live on 2026-11-21, and Result scraped (result-scraped) before it. A country, industry or period without a Creative Center list returns an error and is free. Creative Center's video lists answer slowly outside the US (often 5–20 seconds per list of 4 videos), so there a request may return fewer rows than maxResults: no list is started in the last 21 seconds before the deadline, and the rows already read are returned and charged. Each request has a 60-second deadline and a 1 MiB response cap, and one server works on at most eight requests at once. Nothing is cached. Errors use { "ok": false, "error": { "code": "...", "message": "...", "retryable": false } }: 400 INVALID_COUNTRY, UNSUPPORTED_COUNTRY, INVALID_PERIOD, INVALID_LIMIT, INVALID_INDUSTRY, INVALID_SORT or INVALID_INPUT; 402 spending limit; 404 NO_RESULTS or unknown route; 405 wrong method; 413 RESPONSE_TOO_LARGE; 502 BLOCKED, UPSTREAM_ERROR or charging failure; 503 server busy or stopping; 504 TIMEOUT. Failed requests are free. Retry only when retryable is true. The Server tab shows the full OpenAPI description.