Tiktok Hashtag Scraper

Tiktok Hashtag Scraper

Tiktok Hashtag Scraper is a fast, Playwright-powered Apify actor that collects TikTok videos for any hashtag, keyword, or username and exports structured data such as captions, creators, views, likes, comments, shares, sounds, and publish dates. It solves the time-consuming task of manual hashtag research by automating data collection and formatting, making it ideal for marketers, developers, data analysts, and researchers. Use it as a TikTok hashtag extractor and TikTok video hashtag scraper to track trends at scale, power analytics, and optimize content strategies.

What data / output can you get?

Below are the core JSON fields this actor saves to the Apify Dataset for each collected video. Values are examples to illustrate the format.

Data type	Description	Example value
hashtag	The input hashtag/term used for the run (added before saving)	travel
id	TikTok video ID	7568815616677661970
text	Video description/caption	Exploring Cox’s Bazar 🌊
createTimeISO	ISO timestamp for publish time	2025-11-04T16:30:16Z
webVideoUrl	Public video URL	https://www.tiktok.com/@jannatthelunatictraveler/video/7568815616677661970
mediaUrls	Array of available video URLs (play/download/bitrates)	["https://v16-webapp-prime.tiktok.com/video/..."]
authorMeta.name	Author’s uniqueId (handle)	jannatthelunatictraveler
authorMeta.fans	Author follower count	12000
videoMeta.duration	Video duration in seconds	176
diggCount	Number of likes	4947
shareCount	Number of shares	1384
playCount	Number of views	176800
commentCount	Number of comments	62
musicMeta.musicName	Track title used in the video	original sound
hashtags[].name	Hashtags detected in the post/challenges	foryoupage

Notes:

• Additional fields include createTime (epoch), isAd, isMuted, authorMeta (full object), musicMeta (full object), videoMeta (full object), collectCount, mentions (array), and more.
• Export results to CSV, JSON, or Excel directly from the Apify Dataset to export TikTok hashtags and build dashboards.

Key features

• 🔎 Precise hashtag video extraction Collects videos, captions, engagement metrics (views, likes, shares, comments), author stats, and music details for any provided hashtag/keyword. Works great as a TikTok hashtag finder and TikTok hashtag analytics tool.

• ⚡ Scalable scraping with Playwright Uses Playwright-driven browser automation with smart scrolling and API interception to retrieve large batches reliably and scrape TikTok hashtags at scale.

• 📦 Clean, structured exports Results are saved to the Apify Dataset with consistent JSON keys. Easily export to CSV/JSON/Excel for analysis or integrate into pipelines to power a TikTok hashtag research tool.

• 🧰 Batch input support Provide multiple terms in startUrls to process many hashtags in parallel. Ideal for building a TikTok trending hashtags scraper or TikTok hashtag tracker workflow.

• 🌐 Proxy configuration Configure proxyConfiguration to improve stability. If TikTok rejects a proxy, automatic fallback is applied.

• 👨‍💻 Developer-ready Built as an Apify actor, so you can trigger runs via the Apify platform and pull datasets via API, making it a practical alternative to a TikTok hashtag scraper Python script in production pipelines.

• 🏗️ Production reliability Robust pagination, de-duplication, and sorting logic (date/popularity) in code deliver consistent results for sustained monitoring and analytics.

How to use Tiktok Hashtag Scraper – step by step

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

2. Open the Tiktok Hashtag Scraper actor Find “tiktok-hashtag-scraper” in Apify and open the input form.

3. Add your input terms In startUrls, enter hashtags (without #), usernames (without @), or keywords. You can paste multiple values (e.g., travel, fitness, cooking).

4. Set collection limits Use maxData to control how many videos to collect per term (1–1000; default from the schema is 10).

5. Configure proxies (optional) Adjust proxyConfiguration to improve stability. If a proxy is rejected by TikTok, the actor applies automatic fallback.

6. Run the actor Click Start to launch scraping. The actor navigates to the corresponding TikTok tag pages and collects video data.

7. Download results When the run finishes, open the Dataset tab to export JSON, CSV, or Excel for reporting, enrichment, or BI.

Pro tip: Advanced users can include sortOrder in the input (values: date, popularity, or default relevance) to influence result ordering before export.

Use cases

Use case name	Description
Marketing teams — campaign hashtag analysis	Analyze engagement (views, likes, comments, shares) across target hashtags to optimize performance and creative strategy.
Creators — TikTok hashtag finder	Discover effective tags for upcoming videos by reviewing top posts and author stats under each hashtag.
Analytics — TikTok trending hashtags scraper	Track hashtags over time to quantify trend velocity and peak windows for publishing.
Research — dataset building	Export clean records for academic and market research on content diffusion and creator ecosystems.
Ecommerce — product/tag intelligence	Identify which product-related hashtags drive views and shares to inform merchandising and TikTok Shop content.
Engineering — API/data pipeline	Automate runs and pull datasets into warehousing or Python-based analytics to build a repeatable TikTok hashtag tracker.
Social listening — topic monitoring	Monitor mentions and related hashtags to map topic clusters and content opportunities.

Why choose Tiktok Hashtag Scraper?

This actor focuses on precision, automation, and reliability for structured TikTok hashtag intelligence.

• ✅ Accurate, structured fields ready for analysis (no manual cleanup)
• ⚡ Playwright-powered collection with smart pagination for scale
• 📊 Easy exports from the Apify Dataset (CSV, JSON, Excel)
• 🧩 Developer-friendly for API pipelines and Python integrations
• 🛡️ Stable with proxyConfiguration and automatic fallback behavior
• 🔄 Parallel processing across multiple startUrls for batch workflows
• 🧱 More reliable than lightweight browser extensions or ad-hoc scripts

In short: a production-grade TikTok hashtag search tool that outperforms unstable alternatives with consistent, analytics-ready output.

Is it legal / ethical to use Tiktok Hashtag Scraper?

Yes—when done responsibly. This actor collects publicly available TikTok data associated with hashtags and public posts.

Guidelines for compliant use:

• Only collect public content and metrics.
• Do not scrape private or restricted data.
• Review and respect TikTok’s Terms of Service.
• Ensure your use complies with applicable data protection laws (e.g., GDPR, CCPA).
• Consult your legal team for edge cases or specific jurisdictions.

Input parameters & output format

Input parameters (JSON example)

{
  "startUrls": [
    "travel",
    "fitness",
    "cooking"
  ],
  "maxData": 25,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameter reference:

• startUrls (array) — List of TikTok hashtags (without #), usernames (without @), or keywords to scrape. Required: yes. Default: none (prefill: ["travel"]).
• maxData (integer) — Maximum number of videos to collect per hashtag/username/keyword. Range: 1–1000. Default: 10.
• proxyConfiguration (object) — Choose which proxies to use. If TikTok rejects the proxy, automatic fallback will occur. Default: {"useApifyProxy": false}.

Notes:

• The actor’s runtime will fall back to 200 items per term if maxData is not provided programmatically, but the input schema default is 10.
• Advanced (optional): The code recognizes sortOrder ("date", "popularity", or default "relevance") for result ordering.

Output format (JSON example)

Each dataset item represents a single TikTok video record. Example:

{
  "hashtag": "travel",
  "id": "7568815616677661970",
  "text": "Video description text...",
  "createTime": 1762252216,
  "createTimeISO": "2025-11-04T16:30:16Z",
  "isAd": false,
  "isMuted": false,
  "authorMeta": {
    "id": "7028153025829602309",
    "name": "jannatthelunatictraveler",
    "nickName": "jannatthelunatictraveler",
    "verified": false,
    "signature": "Travel Vlogger || Travel Film Maker",
    "bioLink": null,
    "avatar": "https://...",
    "privateAccount": false,
    "ttSeller": false,
    "following": 1,
    "fans": 12000,
    "heart": 208500,
    "video": 100,
    "digg": 48
  },
  "musicMeta": {
    "musicName": "original sound",
    "musicAuthor": "jannatthelunatictraveler",
    "musicOriginal": true,
    "musicAlbum": "",
    "playUrl": "https://...",
    "coverMediumUrl": "https://...",
    "musicId": "7568815657828125447"
  },
  "webVideoUrl": "https://www.tiktok.com/@jannatthelunatictraveler/video/7568815616677661970",
  "mediaUrls": [
    "https://v16-webapp-prime.tiktok.com/video/...",
    "https://v19-webapp-prime.tiktok.com/video/..."
  ],
  "videoMeta": {
    "height": 1024,
    "width": 576,
    "duration": 176,
    "coverUrl": "https://...",
    "originalCoverUrl": "https://...",
    "definition": "540p",
    "format": "mp4",
    "originalDownloadAddr": "https://...",
    "downloadAddr": "https://..."
  },
  "diggCount": 4947,
  "shareCount": 1384,
  "playCount": 176800,
  "collectCount": 1705,
  "commentCount": 62,
  "mentions": [],
  "hashtags": [
    { "name": "foryoupage" },
    { "name": "viralreels" },
    { "name": "bangladesh" }
  ]
}

Field notes:

• createTimeISO may be null if the source timestamp cannot be converted.
• authorMeta.bioLink may be null when not available.
• mediaUrls aggregates multiple playable/downloadable sources when available.

FAQ

Is there a free version of Tiktok Hashtag Scraper?

You can start by running the actor on Apify with available trial minutes. For full details and pricing, see the actor’s Apify listing.

Can I use it as a TikTok hashtag extractor with Python?

Yes. As an Apify actor, you can trigger runs and fetch datasets via the Apify API from Python, making it a practical alternative to a TikTok hashtag scraper Python script.

Does it support trending or recent sorting?

Yes. The code supports an optional sortOrder input with values like date and popularity, in addition to the default relevance ordering.

What data types does it collect?

It exports video IDs, captions, timestamps, author metadata (including follower counts), music metadata, media URLs, engagement metrics (views, likes, shares, comments), detected hashtags, and more.

How many items can I collect per hashtag?

You can set maxData between 1 and 1000 per term (default from the schema is 10). The actor’s runtime also has a 200-item internal fallback if maxData isn’t supplied programmatically.

Is this a TikTok hashtag scraper Chrome extension?

No. This is a server-side Apify actor using Playwright for reliability and scale. Export results to CSV/JSON/Excel without installing a browser extension.

Is it legal to scrape TikTok hashtags?

Yes—when you collect public data and use it responsibly. Always respect TikTok’s Terms of Service and applicable regulations.

Can I export TikTok hashtags and videos for analytics?

Yes. All results are saved to the Apify Dataset, where you can export to JSON, CSV, or Excel for dashboards, BI tools, and research.

Final thoughts

Tiktok Hashtag Scraper is built to collect structured TikTok hashtag video data at scale. By automating discovery and export of captions, creators, engagement metrics, and media links, it serves marketers, developers, analysts, and researchers who need a dependable TikTok hashtag search tool. Use it to scrape TikTok hashtags, power analytics-ready datasets, and integrate with your workflows or APIs. Start extracting smarter hashtag insights and stay ahead of fast-moving TikTok trends.