Scrape TikTok Trending Videos

Scrape TikTok Trending Videos — Country-Level Trending Charts with Engagement Data

Pull TikTok's trending video charts for any of 24 countries, ranked by views, likes, comments or reposts, over a 7-day or 30-day window.

Each video comes back with its ID, title, cover image, duration, region and direct TikTok URL — and, when detailed mode is enabled, likes, comments, bookmarks, shares and a playable video link.

---

What is Scrape TikTok Trending Videos?

TikTok publishes trending video rankings through its Creative Center, but the interface is built for browsing, not exporting — there is no download, no API key, and no way to compare markets side by side.

This Actor reads those charts programmatically. Pick a country, a ranking metric and a time window, and it returns the trending list as rows.

The design point worth understanding is the two-tier output. The base chart data is cheap and fast. Turning on detailed video data triggers an additional per-video lookup that adds engagement statistics and a video link — richer, but slower. You choose which trade-off you want per run.

---

What data can you extract?

Always returned

Field	Description
id	Video identifier in the trending chart
item_id	TikTok item ID
item_url	Direct link to the video on TikTok
title	Video title / caption as shown in the chart
cover	Cover image URL
duration	Video length
region, country_code	Market the chart was pulled for

Added with includeDetailedVideoData

Field	Description
likes	Like count
comments	Comment count
bookmarks	Saves
shares	Shares / reposts
videoUrl	Playable video link (expiring — see limits)

---

Why teams scrape TikTok trending videos

For content and social teams

Trending charts tell you which formats, hooks and topics are working in a specific market right now. Sorting by like rather than vv (views) surfaces content that resonated rather than content that merely got distribution.

For market localisation

Running the same query across several countries shows how differently a format performs by market — the fastest way to decide whether a campaign concept travels.

For competitor and category research

If your niche appears in trending charts, so do your competitors. The item_url gives you the exact video to study.

For creator discovery

Trending videos surface creators before their follower counts catch up. Opening item_url from a chart is how you find talent early.

For trend tracking over time

Scheduled runs build a longitudinal record of what trended in a market, which is genuinely hard to reconstruct after the fact — trending charts do not have an archive.

For agencies and reporting

A weekly export by country, sorted by your chosen metric, is a ready-made trend digest for client reporting.

---

How to scrape TikTok trending videos step by step

1. Open the Actor and pick a Country Code — e.g. US.
2. Choose Sort By: vv (views), like, comment or repost.
3. Choose a Period: last 7 or 30 days.
4. Set Max Items.
5. Decide whether to enable Include Detailed Video Data (slower, richer).
6. Click Start and export the Output tab as CSV, Excel or JSON.

---

⬇️ Input

Example input

{
  "countryCode": "US",
  "sortBy": "like",
  "period": "7",
  "maxItems": 50,
  "includeDetailedVideoData": true
}

Input reference

Field	Type	Default	Description
countryCode	string	US	Required. Market to scrape. 24 countries: US, GB, CA, AU, DE, FR, IT, ES, BR, JP, KR, TW, TH, VN, PH, MY, SG, ID, IL, EG, SA, AE, TR, RU.
sortBy	string	vv	Required. Ranking metric: vv (views / hot), like, comment, repost (shares).
period	string	7	Time window: last 7 or 30 days.
maxItems	integer	10	Maximum videos to collect.
includeDetailedVideoData	boolean	false	Fetch engagement statistics and a video link per video. Adds one lookup per video, so runs take noticeably longer.

---

⬆️ Output

Example output — detailed mode

{
  "id": "7412345678901234567",
  "item_id": "7412345678901234567",
  "item_url": "https://www.tiktok.com/@examplecreator/video/7412345678901234567",
  "title": "3 kitchen tricks I wish I knew sooner",
  "cover": "https://p16-sign.tiktokcdn.com/…",
  "duration": 41,
  "region": "US",
  "country_code": "US",
  "likes": 184000,
  "comments": 3120,
  "bookmarks": 22140,
  "shares": 14800,
  "videoUrl": "https://v16-webapp.tiktok.com/…"
}

Without includeDetailedVideoData, the last five fields are omitted and the run is substantially faster.

Illustrative values — a live run returns current TikTok data.

---

Usage recipes

This week's most-liked videos in a market

{
  "countryCode": "GB",
  "sortBy": "like",
  "period": "7",
  "maxItems": 100,
  "includeDetailedVideoData": true
}

Compare markets

Run the same configuration with countryCode set to US, GB, DE and BR, then merge the exports. Comparing which formats trend where is the core of localisation research.

Find shareable formats

{
  "countryCode": "US",
  "sortBy": "repost",
  "period": "30",
  "maxItems": 100
}

Shares are a stronger signal than views — people forward content they want to be associated with.

Fast, cheap chart snapshot

{
  "countryCode": "US",
  "sortBy": "vv",
  "period": "7",
  "maxItems": 200,
  "includeDetailedVideoData": false
}

Weekly trend digest

Save a Task per market, attach a weekly Schedule, and route the results into a Google Sheet or Slack channel for a standing report.

---

How does this compare to TikTok's official API?

TikTok's Research API offers query access to public content, but it is restricted to approved academic and non-profit researchers in eligible regions, with an application process and usage terms. The Display API covers a user's own authorised content, and the Commercial Content API is scoped to advertising transparency data — none of them hand you the trending charts as an export.

This Actor reads the publicly published trending rankings that TikTok surfaces for marketers, with no application, no key and no eligibility requirements.

---

Integrate and automate

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_API_TOKEN>")

run = client.actor("scraperforge/tiktok-trending-videos-scraper").call(run_input={
    "countryCode": "US",
    "sortBy": "like",
    "period": "7",
    "maxItems": 50,
    "includeDetailedVideoData": True,
})

for v in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(v.get("likes"), "|", v["title"], "|", v["item_url"])

JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_API_TOKEN>' });

const run = await client.actor('scraperforge/tiktok-trending-videos-scraper').call({
    countryCode: 'US',
    sortBy: 'like',
    period: '7',
    maxItems: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

REST API

curl -X POST "https://api.apify.com/v2/acts/scraperforge~tiktok-trending-videos-scraper/runs?token=<YOUR_APIFY_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"countryCode":"US","sortBy":"like","period":"7","maxItems":50}'

n8n, Make, Zapier and AI agents

Call the Actor from n8n, Make, Zapier or an MCP-capable agent — for example, an agent that pulls weekly trends and drafts content ideas from the titles.

Schedules and webhooks

Attach a Schedule for a recurring trend digest, and use webhooks or the Google Sheets / Airtable / Slack integrations to deliver it.

---

Pricing and what you are charged for

Pay-per-event: a small Actor-start charge plus a charge per video row delivered. maxItems is the cost lever.

Detailed mode costs time, not extra rows — engagement fields are added to the same row. Turn it off when you only need the chart itself.

Current rates are on the Pricing tab of this Actor's page, and Apify shows an estimate before and during every run.

---

Limits, reliability and blocking

• 24 countries only. These are the markets TikTok publishes trending charts for; other countries are not available.
• Two time windows: 7 or 30 days. There is no custom date range and no historical archive — you can only capture what is trending now, which is exactly why scheduled runs are valuable.
• videoUrl links expire. They are short-lived CDN URLs; fetch anything you need promptly.
• Detailed mode adds one lookup per video, so a 200-item run takes considerably longer than the same run without it.
• Engagement values are point-in-time and change constantly. Timestamp your runs for trend work.
• Some detail fields can be missing when TikTok does not expose them for a given video — they come back empty rather than estimated.
• Chart contents are TikTok's own ranking, not a complete view of everything performing in a market.
• Default run options are 4 GB memory and a 1-hour timeout.

---

Is it legal to scrape TikTok trending videos?

This Actor reads publicly published trending rankings and public video metadata — the same information TikTok surfaces to marketers and any visitor. It does not log in, follow accounts, or access private content.

Videos, titles and cover images remain the intellectual property of the creators who made them. Use the data for research, trend analysis and content planning; do not republish creators' videos as your own, and credit and link back where you reference them. Creator handles are personal data — handle them under GDPR and comparable rules if you store them. You are responsible for ensuring your use complies with TikTok's terms and applicable law.

---

❓ Frequently asked questions

Do I need a TikTok account or API key?

No. The Actor reads publicly published trending data without authentication.

Which countries are supported?

24 markets across the Americas, Europe, the Middle East and Asia-Pacific — see the input reference for the full list.

What does sortBy actually change?

Which metric TikTok ranks the chart by: vv is views (the "hot" default), and like, comment and repost rank by engagement instead. They return meaningfully different videos.

Can I get more than 30 days of history?

No. TikTok only publishes 7-day and 30-day windows. If you need a longer history, schedule runs and build it yourself.

What does detailed mode add?

Likes, comments, bookmarks, shares and a video link — at the cost of one extra lookup per video.

Why is videoUrl broken later?

Those are expiring CDN links. They work at scrape time and stop working shortly afterwards; that is TikTok's behaviour, not a bug.

Does it return the creator's profile?

The chart provides the video URL, which contains the creator's handle. For full creator data, use the trending creator Actors linked below.

Can I track trends over time?

Yes — schedule the run. Because TikTok offers no archive, a scheduled export is the only way to build trend history.

Which export format should I use?

CSV or Excel — the rows are flat and ready for analysis.

---

🔗 Related scrapers

• TikTok Trending Videos Insights — deeper analytics on trending video performance.
• TikTok Trending Creator Scraper — the creators behind the trends.
• TikTok Trending Hashtags Scraper — hashtag-level trend rankings.
• TikTok Search Scraper — keyword search when you already know the topic.

Browse the full collection on the ScraperForge profile.

---

💬 Feedback

Need more countries, longer windows, or creator-level enrichment? Open an issue on the Issues tab of this Actor.