Tiktok Discover Scraper

Tiktok Discover Scraper

Tiktok Discover Scraper is a Playwright-powered Apify actor that collects trending TikTok videos, creators, hashtags, and sounds from public Discover and Tag pages — complete with titles, links, and engagement metrics. It solves the manual research problem by automating collection from TikTok’s Discover/search surfaces, acting as a TikTok Discover page scraper and TikTok Discover data extractor for marketers, developers, analysts, and researchers. Use this TikTok Discover crawler at scale to power trend analysis, content planning, influencer discovery, and social listening workflows with clean, structured data.

What data / output can you get?

Below are real fields produced by the actor and pushed to the Apify dataset. Each record represents one TikTok video discovered for a given hashtag/keyword.

Data type	Description	Example value
id	Unique video ID	"7574074787564178709"
text	Video caption text	"Training day with the team 💪⚽"
createTime / createTimeISO	Unix timestamp and ISO UTC	1763476713 / "2025-11-18T14:38:33Z"
webVideoUrl	Public TikTok video URL	"https://www.tiktok.com/@user/video/7574074787564178709"
playCount	Views (plays)	471300
diggCount	Likes	39900
shareCount	Shares	2031
commentCount	Comments	595
authorMeta	Author object (id, name, nickName, verified, followers, etc.)	{"name":"its_nirob.11","fans":54700,...}
musicMeta	Sound info (musicName, musicAuthor, musicId, etc.)	{"musicName":"original sound","musicId":"7502745955301821185"}
mediaUrls	Direct media links when available	["https://v16-webapp-prime.tiktok.com/video/..."]
videoMeta	Video details (duration, width/height, covers, subtitles, slideshow images)	{"duration":19,"coverUrl":"https://..."}
hashtags	Extracted challenges/hashtags used in the post	[{"id":"1653...","name":"football"}]
isAd / isMuted / isSlideshow / isPinned	Flags for ad, audio, slideshow, or pinned	false / false / false / false
input	Original search term used	"football"
discoveryInfo	Context about the Discover page (url, tag, type)	{"url":"https://www.tiktok.com/discover/football"}
hashtag / count	Enrichment for live streaming to the dataset (keyword and running counter)	"football" / 12

Bonus metadata includes subtitleUrls and slideshowImages (when present). You can download results from the Apify dataset in JSON, CSV, or Excel.

Key features

• 🔴 Real-time dataset streaming
  Each discovered video is pushed instantly with hashtag and count, so your output updates live during the run.

• 🧠 Smart proxy fallback logic
  Starts with no proxy by default; on rejection it falls back to datacenter proxy, then to residential proxy, retrying residential up to 3 times and sticking with it for the remaining requests.

• 🔁 Dual-source discovery (discover + tag)
  Collects from both /discover/{keyword} and /tag/{keyword} endpoints to maximize coverage of TikTok Discover trends.

• 🧹 De-duplication and precise limits
  Avoids duplicate video IDs and respects maxItems per hashtag/keyword; set 0 for unlimited collection.

• 🧾 Flexible inputs for search workflows
  Paste plain keywords, hashtags (with or without “#”), or full TikTok search URLs (…/search?q=keyword). The actor parses and normalizes them automatically.

• ⚙️ Playwright + Chromium reliability
  Headless Chromium with robust scrolling, click, and hover strategies to trigger TikTok APIs behind the Discover interface.

• 👩‍💻 Developer-friendly (Python actor)
  Built in Python using the Apify SDK. Access outputs programmatically via the Apify API for pipeline integrations and a Python TikTok Discover scraper workflow.

• 🛠️ Production-ready on Apify
  Runs on Apify cloud infrastructure with dataset storage and proxy management, making it a stable TikTok Discover scraping tool and TikTok Discover API alternative.

How to use Tiktok Discover Scraper - step by step

1. Sign up or log in to Apify.
2. Open the Tiktok Discover Scraper actor (this listing).
3. Add input in “TikTok URLs, Usernames, or Keywords”:
   • Examples: “Cristiano Ronaldo”, “football”, “#highlights”, or “https://www.tiktok.com/search?q=football”.
   • You can paste multiple entries; the actor supports bulk input.
4. Set “Maximum Items per Hashtag/Keyword” (maxItems):
   • Use a positive integer to limit per keyword (e.g., 10). Set 0 for unlimited.
5. Configure “Proxy Configuration” if needed:
   • By default, no proxy is used. Enable Apify Proxy if TikTok blocks requests; the actor will automatically fall back to datacenter and then residential with retries.
6. Click Start to run. The actor navigates to TikTok Discover/Tag pages, scrolls, and captures API responses. Results stream to the dataset in real time.
7. Download results from the run’s Dataset tab or via the Apify API in JSON, CSV, or Excel.

Pro tip: Chain the dataset to dashboards, a data warehouse, or use the Apify API to build a no-code TikTok Discover automation with your existing tools.

Use cases

Use case	Description
Marketing trend analysis	Track emerging topics and measure engagement to inform campaign themes and timing.
Content planning for creators	Identify high-performing hashtags and sounds to plan posts that align with TikTok Discover trends.
Influencer discovery	Surface creators active on your niche keywords by analyzing authorMeta and engagement metrics.
Social listening & reporting	Monitor mentions, hashtags, and video performance to power weekly or monthly trend reports.
SEO & keyword intelligence	Explore Discover search results to validate keyword demand and cross-channel content opportunities.
Data science & ML datasets	Export structured fields (counts, metadata, timestamps) for modeling and trend detection pipelines.
Developer pipelines (API)	Use the Apify API to integrate this TikTok Discover crawler into ETL/ELT jobs and analytics stacks.

Why choose Tiktok Discover Scraper?

Delivering precision, automation, and reliability, this actor is optimized for TikTok Discover data extraction at scale.

• ✅ Accurate, structured records with video, author, sound, and engagement metadata
• ⚡ Bulk-friendly: process multiple keywords/hashtags or search URLs in one run
• 🔌 Developer access: Python actor on Apify with API-based exports for pipelines
• 🛡️ Ethical by design: collects only publicly available TikTok data (no login)
• 📈 Stable vs. extensions: cloud infrastructure, Playwright automation, and robust proxy fallback
• 💾 Dataset-ready outputs that are easy to analyze or feed into BI tools

In short, it’s a production-grade TikTok Discover scraping tool and TikTok Discover API alternative without the instability of browser plugins.

Is it legal / ethical to use Tiktok Discover Scraper?

Yes — when used responsibly. This actor accesses only publicly available TikTok Discover and Tag pages, and does not handle private or authenticated content.

Guidelines for compliant use:

• Scrape public data only and avoid private/authenticated areas.
• Review and respect TikTok’s Terms of Service.
• Follow applicable data protection laws (e.g., GDPR, CCPA).
• Use collected data ethically and consult your legal team for edge cases.

Input parameters & output format

JSON input example

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

Parameters

Field	Type	Required	Default	Description
startUrls	array (stringList editor)	Yes	None	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.
maxItems	integer	No	10	Maximum number of videos to collect per hashtag/keyword. Set to 0 for unlimited.
proxyConfiguration	object (proxy editor)	No	None (prefill useApifyProxy: false)	By default no proxy is used. On rejection, falls back to datacenter proxy, then to residential proxy (and sticks with residential for remaining requests). Residential is retried 3 times before giving up.

JSON output example

Each dataset item contains the search context (hashtag and count) plus the parsed TikTok video object.

{
  "hashtag": "football",
  "count": 12,
  "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": "⚛️_𝘈𝘋𝘐-𝘔𝘐𝘓𝘖𝘌𝘉_🔥",
    "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": "⚡🗣︎𝞼𝞷メ𝞼ꫝɱᴜᴅ!! 🎤⚡",
    "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:

• Some fields may be empty or null depending on availability (e.g., bioLink, subtitleUrls, slideshowImages, videoMeta.format).
• The actor de-duplicates by video id and respects the maxItems limit per input term.

FAQ

Is login required to run this TikTok Discover scraping tool?

No. The actor collects only publicly available data from TikTok Discover and Tag pages and does not require login or cookies.

Can I use plain keywords or full search URLs?

Yes. You can pass keywords like “football”, hashtags with or without “#”, and full TikTok search URLs such as “https://www.tiktok.com/search?q=football”. The actor parses and normalizes them automatically.

How many results can I scrape per keyword?

You control this with maxItems. Set a positive integer to cap results per hashtag/keyword (e.g., 10) or set 0 for unlimited collection.

Does this work as a TikTok trending hashtags or sounds scraper?

It collects videos from Discover/search, including embedded hashtag and sound information (musicMeta). This makes it useful as a TikTok trending hashtags scraper or TikTok trending sounds scraper for analysis tied to your keywords.

Is there an API or Python integration?

Yes. The actor is built in Python and runs on Apify. You can access results via the Apify API in JSON, CSV, or Excel, enabling a Python TikTok Discover scraper workflow and pipeline automation.

How does the proxy fallback work?

By default, the actor uses no proxy. If TikTok rejects or blocks requests, it falls back to a datacenter proxy, then to a residential proxy. Residential is retried up to 3 times before giving up, and once on residential, it sticks with it for remaining requests.

What makes this a TikTok Discover API alternative?

The actor programmatically navigates TikTok’s Discover and Tag pages, captures underlying API responses, and outputs structured JSON. This offers a dependable TikTok Discover API alternative without relying on an official endpoint.

Can I export the data?

Yes. Results are stored in the Apify dataset, which you can download directly or access via API as JSON, CSV, or Excel for dashboards, BI tools, or data pipelines.

Final thoughts

Tiktok Discover Scraper is built for fast, structured extraction of TikTok Discover insights at scale. It delivers real-time streaming results with clean video, author, and sound metadata — ideal for marketers, developers, analysts, and researchers. Use it as a no-code TikTok Discover scraper or integrate via the Apify API for automation. Start extracting smarter trend intelligence and build your TikTok Discover automation pipeline today.