Tiktok Trending Videos Scraper

Tiktok Trending Videos Scraper

Tiktok Trending Videos Scraper is a purpose-built Apify actor that collects real-time trending TikTok videos with clean, structured fields for fast analysis. It solves the pain of manual trend discovery by delivering a ready-to-use dataset you can filter by country, sort by engagement, and optionally enrich with engagement metrics. Built for marketers, developers, data analysts, and researchers, this TikTok trending videos scraper enables scalable trend tracking, campaign planning, and analytics-ready exports.

What data / output can you get?

Below are the exact fields this TikTok trending content scraper stores in the dataset. Fields marked with engagement metrics are included when detailed data is enabled.

Data type	Description	Example value
country_code	Two-letter country code of the trending feed	"AU"
region	Human-readable region name	"Australia"
id	Video ID (string identifier)	"7567957332919913736"
item_id	Item ID (same as video ID in most cases)	"7567957332919913736"
item_url	Canonical TikTok video URL	"https://www.tiktok.com/@mnm_pipi/video/7567957332919913736"
title	Video title text (may include emojis/hashtags)	"Hips don't lie #halloween #shakira #shake #wiggle #boxerdog"
cover	Cover image URL	"https://p16-sign-sg.tiktokcdn.com/..."
duration	Video length in seconds	5
likes*	Total likes (engagement metric)	125430
comments*	Total comments count (engagement metric)	983
shares*	Total shares/reposts (engagement metric)	2140
bookmarks*	Total bookmarks/saves (engagement metric)	356
videoUrl*	Direct video URL when available (may expire)	"https://v16-webapp.tiktok.com/..."

Notes:

• Fields with an asterisk (*) appear only when includeDetailedVideoData is enabled. Depending on availability, these may return null.
• You can export results from the Apify dataset to JSON, CSV, or Excel for downstream analysis.

Key features

• 🚀 Real-time trending feed by country Pull popular videos using a TikTok popular trends endpoint, organized by country_code and region for instant insights.

• 🔎 Flexible sorting controls Choose sortBy values: vv (views), like, comment, or repost (shares) to rank videos the way your analysis needs.

• 🗓️ Time window filters Select period "7" or "30" to focus on the last 7 or 30 days of trends in the creative center feed.

• 📈 Optional engagement enrichment Enable includeDetailedVideoData to add likes, comments, shares, bookmarks, and a direct videoUrl when available.

• 🧪 Robust header and details collection Uses Playwright to extract dynamic headers reliably and falls back to page evaluation to capture engagement metrics.

• 📦 Structured, analytics-ready output Clean JSON records with stable keys like item_url, title, duration, and cover; perfect for dashboards and pipelines.

• 🔁 Scales to your needs Control volume via maxItems (up to 1000 per run) with efficient batching and async fetching.

• 🧰 Developer-friendly on Apify Access runs and datasets via Apify API, schedule jobs, and integrate into no-code or Python workflows seamlessly.

How to use Tiktok Trending Videos Scraper - step by step

1. Sign in to Apify
   Create a free Apify account or log in to your workspace.

2. Open the actor
   Search for “Tiktok Trending Videos Scraper” in the Apify Store and open the actor page.

3. Configure input fields
   Provide your countryCode and sortBy (both required). Optionally adjust period, maxItems, and includeDetailedVideoData.

4. Choose sorting and time window

• sortBy: "vv" (views), "like", "comment", or "repost" (shares)
• period: "7" or "30" days

5. Set result size
   Use maxItems to cap how many videos you collect (1–1000). Start small to validate, then scale up.

6. Start the run
   Click Start. The actor will fetch trending pages, build result items, and optionally enrich engagement metrics.

7. Monitor progress
   Follow live logs to see paging progress and, if enabled, “[details] x/y videos processed” messages.

8. Export your data
   Open the run’s Dataset and export to JSON, CSV, or Excel for analysis, reporting, or ingestion into your tools.

Pro tip: Enable includeDetailedVideoData when you need engagement metrics and a direct videoUrl for deeper analysis. Keep it off for faster, lighter runs.

Use cases

Use case name	Description
Marketing + campaign planning	Identify high-performing formats and themes by country to plan creative that aligns with what’s trending now.
Content strategy for creators	Model topics and lengths with duration and title patterns to improve performance across profiles or brands.
Competitive trend benchmarking	Track how trending videos shift week-over-week by sorting with views, likes, comments, or shares.
Data analytics pipelines	Feed structured records (item_url, title, duration, cover) into dashboards or BI tools for KPI tracking.
API-driven automations	Trigger scheduled runs via Apify API and export to JSON/CSV for no-code or Python workflows.
Academic and market research	Analyze regional trend diffusion using country_code and region with time-bounded (7/30 day) samples.

Why choose Tiktok Trending Videos Scraper?

Built for precision trend discovery and automation, this TikTok popular videos scraper focuses on reliable, structured outputs.

• 🎯 Accurate, focused extraction: Captures only the fields you need for trending analysis with consistent output keys.
• 📊 Sort & filter control: Rank by views, likes, comments, or shares and constrain trends to the last 7 or 30 days.
• ⚡ Scalable runs: Collect up to 1000 items per run with efficient paging and async networking.
• 🧑‍💻 Developer access: Integrate runs and datasets via the Apify API, or connect to Python workflows effortlessly.
• 🛡️ Ethical by design: Accesses publicly available trending endpoints and video pages; no private or authenticated data.
• 🔗 Workflow-ready: Export from Apify datasets to JSON/CSV/Excel and plug into your analytics or automation stack.
• 🧱 Production reliability: Dynamic header extraction and Playwright fallback improve stability over ad-hoc scripts or extensions.

In short, it’s a dependable TikTok trends data extractor that outperforms unstable browser plugins and throwaway scripts.

Is it legal / ethical to use Tiktok Trending Videos Scraper?

Yes—when used responsibly. This tool accesses publicly available trending endpoints and video pages and does not log in or access private data.

Guidelines to follow:

• Collect only publicly available information from TikTok’s public endpoints and pages.
• Comply with relevant regulations (e.g., GDPR, CCPA) when processing any personal data that may appear (e.g., usernames in titles).
• Review and adhere to TikTok’s Terms of Service.
• Consult your legal team for edge cases or commercial usage across jurisdictions.

Input parameters & output format

Example input (JSON)

{
  "countryCode": "AU",
  "sortBy": "repost",
  "period": "7",
  "maxItems": 50,
  "includeDetailedVideoData": true
}

Parameters

Field	Type	Description	Default	Required
countryCode	string	Country code to scrape. Supported: AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN.	"US"	Yes
sortBy	string	Sort the results by (same options as maain.py: hot/view→vv, like, share→repost, comment). Allowed: "vv", "like", "comment", "repost".	"vv"	Yes
period	string	Period to scrape (last 7 or 30 days). Allowed: "7", "30".	"7"	No
maxItems	integer	Maximum number of items to scrape (1–1000).	10	No
includeDetailedVideoData	boolean	If enabled, include engagement statistics (likes, comments, bookmarks, shares) and expiring video links when available.	false	No

Example output (JSON)

[
  {
    "country_code": "AU",
    "cover": "https://p16-sign-sg.tiktokcdn.com/...",
    "duration": 5,
    "id": "7567957332919913736",
    "item_id": "7567957332919913736",
    "item_url": "https://www.tiktok.com/@mnm_pipi/video/7567957332919913736",
    "region": "Australia",
    "title": "Hips don't lie #halloween #shakira #shake #wiggle #boxerdog",
    "likes": 125430,
    "comments": 983,
    "bookmarks": 356,
    "shares": 2140,
    "videoUrl": "https://v16-webapp.tiktok.com/..."
  }
]

Notes:

• The engagement fields likes, comments, bookmarks, shares, and videoUrl are included only when includeDetailedVideoData is true. They may be null if the page does not expose them at runtime.
• When includeDetailedVideoData is false, only the core fields (country_code, cover, duration, id, item_id, item_url, region, title) are output.

FAQ

Is this the best TikTok trending videos scraper for real-time trends?

Yes. It focuses specifically on trending feeds with sorting by views, likes, comments, and shares, plus optional engagement enrichment for deeper insights.

What countries are supported?

Supported country codes are: AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN.

Which sorting options can I use?

Supported sortBy values are "vv" (views), "like", "comment", and "repost" (shares). These map directly to the underlying trend endpoint.

Can I scrape TikTok trending videos for the last 7 or 30 days?

Yes. Set period to "7" or "30" to focus on the last 7 or 30 days of trending videos.

How many results can I collect in one run?

You control volume via maxItems. The allowed range is 1 to 1000 per run.

Does it include likes, comments, shares, and a direct video URL?

Yes—enable includeDetailedVideoData to add likes, comments, bookmarks, shares, and a videoUrl field when available.

Can I use this in a no-code or Python workflow?

Yes. Runs and datasets are accessible via the Apify API, making it suitable for no-code automations and Python-based pipelines.

Is using this scraper legal?

Yes, when used responsibly. It accesses public endpoints and pages, does not require login, and should be used in compliance with TikTok’s Terms and applicable data regulations.

Final thoughts

Tiktok Trending Videos Scraper is built to help you discover and analyze what’s trending on TikTok—fast. With country targeting, flexible sorting, 7/30-day windows, and optional engagement metrics, it delivers clean, structured output that marketers, developers, analysts, and researchers can trust. Access results via the Apify dataset and API to automate exports into your dashboards or Python pipelines. Start extracting smarter TikTok trend insights at scale.