Tiktok Discover Scraper

Tiktok Discover Scraper

The Tiktok Discover Scraper is a fast, structured tiktok discover page scraper that collects trending videos, hashtags, creators, engagement metrics, and audio details directly from TikTok’s Discover and tag pages. It solves the problem of manual trend research by automating tiktok discover data extraction for marketers, developers, data analysts, and researchers. Use this tiktok discover scraper tool to scrape tiktok discover trends, build reports, and power dashboards — at scale and in real time. 🚀

What data / output can you get?

Below are real output fields this tiktok discover web scraper produces, with examples. Results are saved to the Apify dataset and can be exported to JSON, CSV, or Excel.

Data type	Description	Example value
id	Unique video identifier	7574074787564178709
text	Video caption text	“Match highlights from last night…”
createTime	Unix timestamp (seconds)	1763476713
createTimeISO	ISO-8601 UTC timestamp	2025-11-18T14:38:33Z
isAd	Ad flag	false
isMuted	Muted flag	false
authorMeta.name	Author’s unique handle	its_nirob.11
authorMeta.nickName	Author’s display name	“Nirob 🔥”
authorMeta.fans	Follower count	54700
webVideoUrl	Public TikTok video URL	https://www.tiktok.com/@its_nirob.11/video/7574074787564178709
mediaUrls	Array of playable media URLs	["https://v16-webapp-prime.tiktok.com/video/..."]
videoMeta.duration	Video duration (seconds)	19
diggCount	Like count	39900
shareCount	Share count	2031
playCount	View count	471300
collectCount	Favorite/save count	1776
commentCount	Comment count	595
hashtags	Hashtags from the video’s challenges	[{"id":"1653275727519749","name":"football","title":"","cover":""}]
musicMeta.musicName	Music title	“original sound”
musicMeta.musicAuthor	Music author	“creator name 🎤”
input	Original search keyword	football
discoveryInfo.url	Discover source URL	https://www.tiktok.com/discover/football
isSlideshow	Slideshow flag	false
isPinned	Pinned flag	false
hashtag	The scraped hashtag/keyword context	football
count	Sequence number per hashtag in real-time push	1

Bonus: Each record also includes authorMeta (avatar, verified, stats), musicMeta (IDs, covers), videoMeta (dimensions, covers, subtitles, slideshow images), and discoveryInfo (breadcrumbs, relatedTags, tag, type).

Key features

• ⚡ Real-time dataset streaming Pushes each discovered item to the Apify dataset as it’s found, enabling live dashboards and faster feedback loops.

• 🔎 Discover + Tag endpoint coverage Starts with tiktok discover crawler behavior (discover/{keyword}) and falls back to tag pages (tag/{keyword}) to maximize coverage.

• 🔁 Cursor-aware pagination Captures and follows TikTok web API pagination signals (e.g., hasMore/cursor) to collect more items when available.

• 🧭 Smart proxy fallback Built-in logic escalates from no proxy → datacenter → residential (with retries) and then sticks with residential when needed for reliability.

• 🧠 De-duplication across sources Tracks seen video IDs to avoid duplicates when combining Discover and Tag sources.

• 🎵 Trending sounds & creators data Extracts musicMeta and authorMeta so you can use it as a tiktok trending sounds scraper and a creators intelligence source.

• 🧾 Structured, analytics-ready output Clean JSON with engagement metrics, media links, author stats, and discovery metadata — ideal for BI tools and ETL.

• 🧪 Developer friendly Playwright-powered, headless Chromium workflow that captures TikTok’s web API responses — a practical tiktok discover api scraper approach for robust automation.

How to use Tiktok Discover Scraper - step by step

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

2. Open the Tiktok Discover Scraper Launch the actor from your dashboard or the Apify Store.

3. Add input data In startUrls, enter a mix of:

   • Keywords or hashtags (with or without “#”), e.g., football or #football
   • TikTok search URLs, e.g., https://www.tiktok.com/search?q=football

4. Set collection limits Use maxItems to control how many videos to collect per hashtag/keyword (0 for unlimited, up to 500).

5. Configure proxy behavior (optional) Use proxyConfiguration if you want to start with the Apify Proxy. If disabled, the actor starts direct and only falls back when needed based on its built-in logic.

6. Run the actor Click Start. The job opens public Discover or Tag pages, scrolls, and listens to TikTok’s web API to collect items.

7. Monitor live results Records stream into the dataset with hashtag and count fields, so you can watch progress in real time.

8. Export your data Download your dataset as JSON, CSV, or Excel, or access it via the Apify API for integration in your pipelines.

Pro tip: Combine multiple keywords in startUrls to build a broader tiktok trending topics scraper workflow and schedule recurring runs for ongoing monitoring.

Use cases

Use case	Description
Marketing trend tracking	Monitor engagement (plays, likes, comments, shares) across keywords to inform campaign timing and creative angles.
Content planning for creators	Extract trending hashtags, creators, and sounds to guide weekly content calendars and ideation.
Social listening & reporting	Aggregate video metrics and hashtags to quantify conversation volume in your niche for stakeholders.
Influencer discovery	Identify creators rising within specific topics based on authorMeta and per-video performance.
SEO & topic research	Use Discover/tag outputs as a tiktok explore page scraper to spot adjacent topics and tag clusters worth targeting.
Data pipelines & BI	Feed structured JSON into ETL for dashboards or enrichment; perfect for analysts and tiktok discover automation workflows.
Academic & market research	Analyze content dynamics and audience behavior using structured counts and timestamps (createTime/ISO).

Why choose Tiktok Discover Scraper?

This actor focuses on precision trend extraction from public TikTok Discover and tag pages with production-ready reliability.

• ✅ Accurate, structured fields tuned for analysis (engagement metrics, author and music metadata)
• ⚙️ Robust fallback logic for scale (no proxy → datacenter → residential with retries)
• 📡 Real-time pushing to dataset for live monitoring and faster iteration
• 📦 Clean exports to JSON, CSV, or Excel via the Apify dataset
• 🧩 Developer-ready, Playwright-based tiktok discover crawler that captures web API responses
• 🛡️ Public data only — designed for ethical, responsible use
• 🔁 Better than unstable extensions: resilient headless browser automation with error handling and de-duplication

Bottom line: a reliable tiktok trending videos scraper that turns Discover insights into analytics-ready data.

Is it legal / ethical to use Tiktok Discover Scraper?

Yes — when done responsibly. This tool accesses publicly available TikTok Discover and tag content without authentication.

Guidelines for compliant use:

• Only collect publicly visible data
• Review and respect TikTok’s Terms of Service
• Avoid attempts to access private or authenticated content
• Follow applicable data protection laws (e.g., GDPR, CCPA)
• Consult your legal team for edge cases and jurisdiction-specific policies

Input parameters & output format

JSON input example

{
  "startUrls": [
    "football",
    "https://www.tiktok.com/search?q=football"
  ],
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input parameters (from schema):

• startUrls (array, required)

  • Description: List one or more TikTok URLs (e.g., https://www.tiktok.com/search?q=hashtag), usernames (e.g., username), or keywords/hashtags (e.g., #hashtag or hashtag). Supports bulk input.
  • Default: none
  • Required: Yes

• maxItems (integer, optional)

  • Description: Maximum number of videos to collect per hashtag/keyword. Leave empty or set to 0 for unlimited.
  • Range: 0–500
  • Default: 10
  • Required: No

• proxyConfiguration (object, optional)

  • Description: By default no proxy is used. If TikTok rejects or blocks requests, the actor fallbacks to datacenter proxy, then to residential proxy (and sticks with residential for remaining requests). Residential is retried 3 times before giving up.
  • Default: none (prefill uses useApifyProxy: false)
  • Required: No

JSON output example

Each dataset item is a single video record enriched with the original search context.

{
  "hashtag": "football",
  "count": 1,
  "id": "7574074787564178709",
  "text": "Video caption text...",
  "createTime": 1763476713,
  "createTimeISO": "2025-11-18T14:38:33Z",
  "isAd": false,
  "isMuted": false,
  "authorMeta": {
    "id": "7475549234427888641",
    "name": "its_nirob.11",
    "nickName": "Nirob 🔥",
    "verified": false,
    "signature": "Account signature...",
    "bioLink": null,
    "avatar": "https://...",
    "privateAccount": false,
    "following": 162,
    "fans": 54700,
    "heart": 4700000,
    "video": 994,
    "digg": 6037
  },
  "musicMeta": {
    "musicName": "original sound",
    "musicAuthor": "Creator 🎤",
    "musicOriginal": true,
    "musicAlbum": "",
    "playUrl": "https://...",
    "coverMediumUrl": "https://...",
    "musicId": "7502745955301821185"
  },
  "webVideoUrl": "https://www.tiktok.com/@its_nirob.11/video/7574074787564178709",
  "mediaUrls": [
    "https://v16-webapp-prime.tiktok.com/video/..."
  ],
  "videoMeta": {
    "height": 576,
    "width": 768,
    "duration": 19,
    "coverUrl": "https://...",
    "originalCoverUrl": "https://...",
    "definition": "540p",
    "format": "mp4",
    "originalDownloadAddr": "https://...",
    "downloadAddr": "https://...",
    "subtitleUrls": [],
    "slideshowImages": []
  },
  "diggCount": 39900,
  "shareCount": 2031,
  "playCount": 471300,
  "collectCount": 1776,
  "commentCount": 595,
  "mentions": [],
  "hashtags": [
    {
      "id": "1653275727519749",
      "name": "football",
      "title": "",
      "cover": ""
    }
  ],
  "effectStickers": [],
  "isSlideshow": false,
  "isPinned": false,
  "input": "football",
  "discoveryInfo": {
    "breadcrumbs": [],
    "relatedTags": [],
    "url": "https://www.tiktok.com/discover/football",
    "tag": "football",
    "type": "discover"
  }
}

Notes:

• Each record includes both hashtag (the context) and input (the original search term).
• Some nested fields may be empty depending on TikTok’s response (e.g., subtitleUrls, slideshowImages, bioLink).

FAQ

Is there a free way to try the Tiktok Discover Scraper?

Yes. You can run the actor on Apify with trial minutes to validate your workflow and outputs before scaling up.

Do I need to log in or provide cookies?

No. The actor navigates public TikTok Discover and tag pages and does not require login credentials in the input.

How many results can I scrape per keyword?

Use maxItems to control volume. The input schema supports up to 500 items per hashtag/keyword per run, or set 0 for unlimited (subject to availability and runtime limits).

Which data points does it return?

The actor outputs video-level fields such as id, text, timestamps, engagement metrics (playCount, diggCount, shareCount, collectCount, commentCount), authorMeta, musicMeta, videoMeta, webVideoUrl, hashtags, and discoveryInfo, plus the hashtag context and per-keyword count.

Does it support proxies and residential IPs?

Yes. It starts without a proxy by default and automatically falls back to datacenter and then residential proxies with retries when TikTok rejects requests. Once on residential, it sticks with it for remaining requests.

Can I use it as a tiktok discover api scraper?

Yes. Under the hood, the actor captures TikTok’s web API responses (e.g., item lists from Discover/Tag) via Playwright and parses them into structured records.

How do I export the results?

Open the run’s dataset and export to JSON, CSV, or Excel, or access the dataset via the Apify API for downstream pipelines and automation.

Can I input search URLs and plain keywords together?

Yes. Provide a mix of TikTok search URLs (e.g., https://www.tiktok.com/search?q=football) and plain keywords/hashtags (with or without #) in startUrls; the actor will normalize them.

Closing CTA / Final thoughts

The Tiktok Discover Scraper is built to turn TikTok Discover insights into structured, analytics-ready data fast. With real-time pushing, proxy fallback, and clean JSON output, it empowers marketers, developers, analysts, and researchers to track trends, creators, and sounds at scale. Export to CSV/JSON/Excel or plug the dataset into your automation pipeline and start extracting smarter TikTok trend intelligence today.