📈 TikTok Trending Scraper

Get trending videos from TikTok's Explore feed, with optional region targeting. Ranked output, ready for content research, marketing analysis, and creator discovery — without an account.

Heads up — TikTok-side deprecation (2026-Q1). TikTok turned off the public Hashtag, Creator, and Music trending feeds at the source. Those modes are kept in the actor for backwards compatibility but now return a single deprecation record so you know what happened. Video trending still works and is the recommended default.

✨ Why Use This Actor?

• 🚀 Real-time trending videos — ranked by TikTok's Explore engine
• 🌍 Region-aware — surface what's trending in a specific country
• 💰 Cheap & fast — HTTP-only, no browser, ~2 seconds per page
• ✅ No login, no API key — fully anonymous, no account setup
• 📊 Stable JSON output — ready for pipelines, databases, BI tools
• 🔁 Up to 500 videos per run with paginated fetching

🎯 Use Cases

• Content research — see what's trending before producing a video
• Marketing intelligence — track viral creators and formats in your niche
• Influencer discovery — find creators riding the current trend wave
• Competitive benchmarking — see which video styles dominate per country
• Academic / research — study cross-region trending patterns over time

📥 Input

Field	Type	Default	Description
content_type	string	"video"	"video" is the only currently-working mode. "hashtag", "creator", "music" are kept for backwards compatibility but TikTok deprecated them — they return a single deprecation record.
country_code	string	"US"	ISO country code (e.g. US, ID, GB, JP, BR, DE). Leave empty for global.
period	string	"7"	Trending window in days (7, 30, 120). Currently used only by the deprecated modes; ignored for video.
industry_id	string	(empty)	Industry filter for hashtag mode only — see table below.
sort_by	string	"popular"	Hashtag: popular / rise. Creator: follower / engagement / avg_views. Ignored for video.
limit	integer	20	Max results to return. Video: 1–500.

Example input

{
    "content_type": "video",
    "country_code": "US",
    "limit": 20
}

📤 Output

Each record is a raw TikTok video object plus the envelope meta fields. No field renaming — what TikTok sends is what you get.

Field	Type	Description
id	string	Video ID
desc	string	Video caption
author	object	Creator info (uniqueId, nickname, avatarThumb, verified, …)
stats	object	Engagement metrics (playCount, diggCount, commentCount, shareCount, collectCount)
video	object	Media URLs (playAddr, downloadAddr, cover, originCover, duration, width, height)
music	object	Sound info (id, title, authorName, playUrl)
challenges	array	Hashtags attached to the video
_rank	integer	Rank position (1 = most trending)
_source	string	"S1-explore-api" (video) or "S1-cc-api" (legacy modes)
_input	object	The input parameters used for this run
_scrapedAt	string	UTC ISO 8601 timestamp

Example output (video, abridged)

{
  "_input": {
    "content_type": "video",
    "country_code": "US",
    "period": 7,
    "industry_id": "",
    "sort_by": "popular"
  },
  "_source": "S1-explore-api",
  "_scrapedAt": "2026-06-02T13:48:01Z",
  "_rank": 1,
  "id": "7637369500161084692",
  "desc": "Jangan asal murah, cek dulu kualitas ayam yang kamu beli! 🚨🐔",
  "createTime": 1762000000,
  "author": {
    "id": "7117389664750683162",
    "uniqueId": "snapfactsss1",
    "nickname": "Snap Facts",
    "verified": false
  },
  "stats": {
    "playCount": 8000000,
    "diggCount": 1200000,
    "commentCount": 3400,
    "shareCount": 12000,
    "collectCount": 45000
  },
  "video": {
    "duration": 21,
    "cover": "https://p16-sign-va.tiktokcdn.com/...",
    "playAddr": "https://v16-webapp-prime.tiktok.com/...",
    "width": 1080,
    "height": 1920
  },
  "music": {
    "title": "original sound - Snap Facts",
    "authorName": "snapfactsss1"
  }
}

Deprecation record (hashtag / creator / music)

When you select a deprecated content type, the dataset receives one record explaining why:

{
  "_input": { "content_type": "hashtag", "country_code": "US", "period": 7, "sort_by": "popular" },
  "_source": "none",
  "_scrapedAt": "2026-06-02T13:48:01Z",
  "_warning": "endpoint_deprecated",
  "_warningDetail": "TikTok's Creative Center backend returns data=null for content_type='hashtag'. The endpoint is server-side deprecated as of 2026-Q1. Use content_type='video' for the only currently-working trending feed."
}

This is intentional: a failing/deprecated input should not silently produce an empty dataset — that's indistinguishable from "no trends found".

🛠️ How It Works

1. You give the actor a content_type and optional region/filters.
2. The actor warms a session, fetches the trending feed from TikTok, and paginates until your limit is reached.
3. Results stream into your dataset with rank position and envelope metadata.

You don't need to manage browsers, accounts, proxies, or session cookies — none of that is required for the public trending feed.

⚠️ Known Limits

• Hashtag / Creator / Music modes: TikTok deprecated the underlying Creative Center endpoints at the source. The actor returns one informative record instead of pretending to work. We'll restore those modes if TikTok brings the endpoints back.
• Region filter on video: TikTok serves the same Explore feed globally with mild regional re-ranking. Setting country_code biases results but won't return an entirely different list.
• Rate: One request per ~0.5 s by default. The Explore API tolerates this without rate-limiting from datacenter IPs.

🔗 Other TikTok Actors in This Suite

• TikTok Comments Extractor — comments + nested replies for any video
• TikTok Post Detail Scraper — full per-video metadata (download URLs, music, stats)
• TikTok Profile + Posts Scraper — profile info + a user's most recent posts in one call
• TikTok Search Scraper — search videos by keyword or hashtag
• TikTok Top Ads Scraper — top-performing ads from Creative Center's Top Ads dashboard