Tiktok Trending Videos Scraper

Tiktok Trending Videos Scraper

Tiktok Trending Videos Scraper is a country-scoped TikTok trend extractor that collects trending video entries with core metadata and optional engagement details, enabling fast, repeatable trend analysis for marketers, developers, analysts, and researchers. It solves the challenge of reliably surfacing what’s trending by country and metric (views, likes, comments, shares) and lets you scale from quick checks to automated, high-volume monitoring. Use it as a TikTok trending scraper for content strategy, a trend data collector for analytics, or a developer-ready actor for workflow automation.

What data / output can you get?

Below are the exact dataset fields this actor stores, as pushed during the run. Fields for engagement appear when detailed data is enabled.

Data type	Description	Example value
country_code	Two-letter country code of the trend source	"US"
cover	Cover image URL for the video	"https://p16-sign.tiktokcdn.com/obj/..."
duration	Video length in seconds	15
id	Video ID	"7234567890123456789"
item_id	Item ID (same as video ID in most cases)	"7234567890123456789"
item_url	Public TikTok URL of the video	"https://www.tiktok.com/@example/video/7234567890123456789"
region	Human-readable region label	"United States"
title	Title/caption string returned by the trend source	"Summer vibes on repeat ☀️🎵"
likes	Number of likes (when detailed data is enabled)	12453
comments	Number of comments (when detailed data is enabled)	382
bookmarks	Number of bookmarks/saves (when detailed data is enabled)	97
shares	Number of shares/reposts (when detailed data is enabled)	241
videoUrl	Direct video URL if available (may be transient; when detailed data is enabled)	"https://v16-webapp.tiktok.com/abcd.../video.mp4"

Notes:

• Engagement fields (likes, comments, bookmarks, shares, videoUrl) are included only when includeDetailedVideoData is true.
• Direct video links may expire and can be missing depending on page availability.
• Export your dataset from Apify in common formats like JSON, CSV, or Excel for downstream analysis.

Key features

• 🚩 Country-scoped trending capture — Pulls trending TikTok video entries by countryCode, so you can localize insights for specific markets.
• 🧭 Flexible sorting — Choose sortBy from vv (views), like, comment, or repost (shares) to focus on the metric that matters.
• 📅 Time-window control — Limit trends to the last 7 or 30 days using the period setting.
• 📈 Optional engagement enrichment — Enable includeDetailedVideoData to fetch likes, comments, bookmarks, shares, and a direct videoUrl when available.
• 🔄 Scalable pagination & limits — Control workload with maxItems (1–1000). The actor fetches pages efficiently and stops at your limit.
• 🧠 Smart detail fetching — Uses fast HTTP scraping first and falls back to Playwright only when needed to retrieve engagement details.
• 🧪 No login required — Works from publicly available endpoints and video pages without credentials.
• 🔗 Integration-ready — Runs on Apify infrastructure with dataset outputs you can connect to pipelines, BI tools, and automations.
• 🧱 Production-grade reliability — Dynamic request headers and headless Chromium ensure consistent trend retrieval.

How to use Tiktok Trending Videos Scraper - step by step

1. Create or log in to your Apify account.
2. Open the Tiktok Trending Videos Scraper actor in the Apify Console.
3. Configure input:
   • Set countryCode (required) to your target market (e.g., "US", "GB", "DE").
   • Set sortBy (required) to "vv", "like", "comment", or "repost".
   • Choose period "7" or "30" for the time window.
   • Set maxItems to control how many records you want (1–1000).
   • Toggle includeDetailedVideoData to enrich results with likes, comments, bookmarks, shares, and videoUrl when available.
4. Start the run. The actor will fetch trending pages and stream items to the dataset.
5. Monitor progress in logs. If detailed data is enabled, you’ll see messages for processed videos.
6. Download results from the Dataset tab in your preferred format (e.g., JSON, CSV, Excel) for analysis and reporting.

Pro Tip: Schedule the actor or chain it with webhooks to keep an always-fresh feed of country-specific trends feeding your dashboards or ML pipelines.

Use cases

Use case name	Description
Marketing trend tracking	Monitor top-performing videos by country and sort metric to spot timely creative patterns that lift campaign performance.
Content ideation for creators	Discover trending formats quickly; export titles and cover links to plan content that aligns with audience interests.
Social analytics enrichment	Append structured trend records to BI tools; filter by region and period for weekly or monthly reporting.
Competitive content watch	Compare traction by likes/comments/shares in your target market (when detailed data is enabled) to benchmark creative performance.
Editorial planning	Identify regional themes and include trend highlights in planning cycles with concrete examples.
API/data pipeline integration	Use Apify’s dataset exports to feed a data lake or downstream scripts for automated analysis and alerting.
Academic & market research	Collect structured trend snapshots across countries and time windows for reproducible studies.

Why choose Tiktok Trending Videos Scraper?

Built for precision and reliability on Apify, this actor focuses on structured, country-scoped trend extraction with optional engagement enrichment.

• 🎯 Accurate, structured fields — Consistent output with clearly named fields for clean ingestion.
• 🌍 Regional insights — Target trends by country and compare markets using consistent logic.
• ⚖️ Configurable scope — Control window (7 or 30 days), sort metric, and maxItems to fit your analysis.
• 👩‍💻 Developer-friendly — Simple JSON input, pushData outputs, and dataset exports for seamless pipelines.
• 🛡️ Safe by design — Uses publicly available endpoints/pages; no login or private data access.
• ⚙️ Automation-ready — Schedule runs and connect datasets to your analytics or CRM stack.
• 🧱 Robust execution — Headless Chromium and dynamic headers provide stable scraping versus brittle browser add-ons.

In short, it’s a focused TikTok trend scraper that outperforms manual methods and unstable tools by delivering consistent, automation-ready outputs.

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

Yes—when used responsibly. This actor collects publicly available information from TikTok trend sources and video pages without accessing private or authenticated data.

Guidelines for compliant use:

• Collect and process only public data.
• Follow TikTok’s terms of service and platform policies.
• Respect applicable data protection laws such as GDPR and CCPA when processing personal data elements that may appear incidentally (e.g., in titles).
• Avoid scraping or storing private or sensitive information.
• Consult your legal team for edge cases or specific compliance requirements.

Input parameters & output format

Example input (JSON)

{
  "countryCode": "US",
  "sortBy": "vv",
  "period": "7",
  "maxItems": 25,
  "includeDetailedVideoData": true
}

Parameters

Field	Type	Required	Default	Description	Allowed values
countryCode	string (select)	Yes	"US"	Country code to scrape	AU, BR, CA, EG, FR, DE, ID, IL, IT, JP, MY, PH, RU, SA, SG, KR, ES, TW, TH, TR, AE, GB, US, VN
sortBy	string (select)	Yes	"vv"	Sort the results by	vv (Views), like (Likes), comment (Comments), repost (Shares)
period	string (select)	No	"7"	Period to scrape (last N days)	"7", "30"
maxItems	integer	No	10	Maximum number of items to scrape (range 1–1000)	1 to 1000
includeDetailedVideoData	boolean	No	false	Include engagement stats (likes, comments, bookmarks, shares) and a direct videoUrl when available	true / false

Notes:

• countryCode and sortBy are required.
• Engagement fields are included only when includeDetailedVideoData is true.

Example output (JSON)

[
  {
    "country_code": "US",
    "cover": "https://p16-sign.tiktokcdn.com/obj/example-cover.jpg",
    "duration": 12,
    "id": "7567000123456789012",
    "item_id": "7567000123456789012",
    "item_url": "https://www.tiktok.com/@example/video/7567000123456789012",
    "region": "United States",
    "title": "POV: first day of spring 🌸",
    "likes": 15423,
    "comments": 402,
    "bookmarks": 118,
    "shares": 263,
    "videoUrl": "https://v16-webapp.tiktok.com/abcd1234/video.mp4"
  },
  {
    "country_code": "US",
    "cover": "https://p16-sign.tiktokcdn.com/obj/example-cover-2.jpg",
    "duration": 8,
    "id": "7567999987654321012",
    "item_id": "7567999987654321012",
    "item_url": "https://www.tiktok.com/@brand/video/7567999987654321012",
    "region": "United States",
    "title": "Quick recipe hack 🔪✨",
    "likes": 8921,
    "comments": 211,
    "bookmarks": 76,
    "shares": 144,
    "videoUrl": "https://v16-webapp.tiktok.com/efgh5678/video.mp4"
  }
]

Field availability notes:

• likes, comments, bookmarks, shares, and videoUrl appear only if includeDetailedVideoData is true.
• videoUrl can be missing or expire depending on page load and availability.
• Core fields (country_code, cover, duration, id, item_id, item_url, region, title) are present for each scraped item.

FAQ

Do I need a TikTok login or cookies to run this?

No. The actor uses public trend endpoints and video pages, so no login or cookies are required.

What sort options are supported?

You can set sortBy to "vv" (views), "like" (likes), "comment" (comments), or "repost" (shares). Choose the metric that matches your analysis goals.

Can I get likes and shares in the output?

Yes, enable includeDetailedVideoData to include likes, comments, bookmarks, shares, and a direct videoUrl when available.

How many results can I scrape per run?

You control this with maxItems, from 1 up to 1000. The actor stops once it reaches your specified limit.

Can I track trends for multiple countries?

Yes—run the actor separately for each countryCode you need and aggregate the datasets in your workflow.

Which time windows are supported?

Set period to "7" for the last 7 days or "30" for the last 30 days of trending data.

What formats can I export the results to?

You can export your Apify dataset in common formats such as JSON, CSV, or Excel for easy ingestion into analytics tools.

Is this scraper legal to use?

Yes—when used responsibly with public data in line with TikTok’s terms and applicable regulations. The actor does not access private or authenticated data.

Final thoughts

Tiktok Trending Videos Scraper is built to deliver structured, country-specific TikTok trend data with optional engagement enrichment. Configure your country, sort metric, and time window, then export clean fields for analysis and reporting. It’s ideal for marketers, analysts, researchers, and developers building automated pipelines. Start integrating the dataset into your workflows or code to keep your trend intelligence fresh and actionable.