Tiktok Hashtag Scraper

Tiktok Hashtag Scraper

Tiktok Hashtag Scraper is an Apify actor that extracts TikTok videos and rich metrics from any hashtag, username, or keyword input. It solves the manual effort of trying to scrape TikTok hashtags by automatically collecting structured data like captions, views, likes, comments, authors, timestamps, media URLs, and more. Built for marketers, developers, data analysts, and researchers, this TikTok hashtag scraper tool functions as a TikTok hashtag extractor you can run at scale for trend tracking, hashtag research, and reporting.

What data / output can you get?

Use this TikTok tag scraper to collect structured, ready-to-analyze fields. Below are the exact output keys pushed to the dataset, with examples:

Field (exact name)	Description	Example value
hashtag	The hashtag/username/keyword that was processed for this item	“travel”
id	TikTok video ID	“7268815616677661970”
text	Video caption/description	“5 tips for budget travel across Europe ✈️🌍”
createTime	Unix timestamp when the video was created	1712252216
createTimeISO	ISO-8601 timestamp for readability	“2024-04-04T16:30:16Z”
webVideoUrl	Public TikTok URL to the video	“https://www.tiktok.com/@jane/video/7268815616677661970”
mediaUrls	Array of playable/download URLs gathered from the video	[“https://.../video/...”]
authorMeta.name	Author’s uniqueId (handle)	“jane”
authorMeta.fans	Author’s follower count	120450
musicMeta.musicName	Music title used in the video	“original sound”
videoMeta.duration	Video duration in seconds	17
diggCount	Like count	4821
shareCount	Share count	132
playCount	View count	178540
collectCount	Favorites/bookmarks count	324
commentCount	Comment count	64
isAd	Whether TikTok labels the post as an ad	false
isMuted	Whether the video is muted	false
hashtags	Array of hashtag objects extracted from the post	[{ “name”: “foryoupage” }, { “name”: “travelhacks” }]

Bonus metadata includes nested objects: authorMeta (author profile stats), musicMeta (track details), and videoMeta (technical info and covers). You can export TikTok hashtags to CSV or JSON from the Apify dataset for analytics, dashboards, and pipelines.

Key features

• 🚀 Playwright-powered reliability Uses headless Chromium via Playwright to capture TikTok web API responses on hashtag pages for stable, production-ready scraping.

• 📈 Rich engagement metrics Collects views (playCount), likes (diggCount), comments (commentCount), shares (shareCount), saves (collectCount), plus timestamps to power a TikTok hashtag analytics scraper workflow.

• 🧭 Flexible inputs (hashtags, usernames, keywords) Accepts a string list in startUrls. Provide “travel”, “@brandhandle” style inputs (without “@”), keywords, or full TikTok URLs—this TikTok hashtag finder adapts automatically.

• 📦 Structured media & links Captures webVideoUrl and mediaUrls along with authorMeta, musicMeta, and videoMeta so you can build a TikTok video hashtag scraper dataset for analysis or reporting.

• 📊 Scalable limits per tag Control volume with maxData (1–1000 items per input), ideal for batch collection and a TikTok trending hashtag scraper workflow.

• 🌐 Proxy configuration Built-in proxyConfiguration support lets you choose proxies; if TikTok rejects the proxy, automatic fallback will occur.

• 💻 Developer-friendly (Python-based) Implemented in Python and deployed on Apify—easy to integrate into your pipelines (TikTok hashtag scraper Python users can trigger runs via the Apify API and export results programmatically).

• 🔄 Automation-ready Orchestrate scheduled runs on Apify, plug the data into BI tools, or connect to internal systems for a TikTok hashtag API scraper pipeline.

How to use Tiktok Hashtag Scraper - step by step

1. Create or log in to your Apify account Access your Apify dashboard to run the actor.

2. Open the Tiktok Hashtag Scraper Find the actor on the Apify Store under the scraply account.

3. Add input data In startUrls, paste a list of items such as:

   • Hashtags without “#” (e.g., “travel”)
   • Usernames without “@” (e.g., “brandhandle”)
   • Keywords (e.g., “fitness”)
   • TikTok URLs (e.g., “https://www.tiktok.com/tag/cooking”)

4. Set limits Use maxData to choose how many videos to collect per input (between 1 and 1000).

5. Configure proxy (optional) Adjust proxyConfiguration if needed. If TikTok rejects the proxy, the tool falls back automatically.

6. Run the actor Click Start. The crawler navigates to each tag page, captures API responses, and parses video items.

7. Download results Open the dataset to export CSV or JSON, or access data via the Apify API for automation.

Pro tip: Chain this with your analytics or warehouse workflow to scrape TikTok hashtags on a schedule and keep your dashboards fresh.

Use cases

Use case	Description
Social media marketing + hashtag research	Identify high-engagement posts and tags to optimize content strategy using a TikTok hashtag research tool.
Influencer discovery & competitor tracking	Collect posts from competitor tags and surface creators consistently using them (TikTok competitor hashtag scraper workflow).
Editorial & content planning	Build a repeatable TikTok video hashtag scraper pipeline that feeds captions, music, and metrics into planning boards.
Performance analytics & BI	Export TikTok hashtags to CSV/JSON and blend with your KPIs for virality and campaign performance dashboards.
Academic & trend research	Measure diffusion of topics across time using createTime and engagement metrics at scale.
Developer/API pipelines	Trigger runs programmatically to build a TikTok hashtag API scraper that feeds internal datasets and apps.

Why choose Tiktok Hashtag Scraper?

This solution is engineered for precision, automation, and reliable output—without brittle browser extensions or copy-paste work.

• ✅ Accurate, structured fields mapped to TikTok posts (ids, captions, metrics, media, author/music/video metadata)
• ⚡ Scalable collection with maxData controls (1–1000 per input) and multi-input support
• 🧪 Python-based implementation with Apify infrastructure for dependable operations
• 🌐 Proxy-ready with automatic fallback behavior for resilient scraping
• 🔒 Public-data focused to support safe, responsible usage
• 💾 Easy exports to CSV/JSON for analysis, reporting, and pipelines
• 💡 Ideal for marketers, analysts, researchers, and TikTok hashtag extractor workflows

In short, it’s a production-grade TikTok hashtag scraper tool built for teams that need consistent, automation-ready results.

Is it legal / ethical to use Tiktok Hashtag Scraper?

Yes—when used responsibly. This actor is designed to collect publicly available TikTok data from hashtag pages and public posts. It does not access private profiles or authenticated content.

Guidelines for compliant use:

• Only collect publicly available data
• Respect TikTok’s Terms of Service and platform policies
• Ensure your use complies with applicable regulations (e.g., GDPR/CCPA) and internal policies
• Use the data ethically and avoid spam or misuse

For edge cases, consult your legal team to confirm compliance with your specific use.

Input parameters & output format

JSON input example

{
  "startUrls": [
    "travel",
    "fitness",
    "https://www.tiktok.com/tag/cooking"
  ],
  "maxData": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Parameters

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

JSON output example

{
  "hashtag": "travel",
  "id": "7268815616677661970",
  "text": "5 tips for budget travel across Europe ✈️🌍",
  "createTime": 1712252216,
  "createTimeISO": "2024-04-04T16:30:16Z",
  "isAd": false,
  "isMuted": false,
  "authorMeta": {
    "id": "7028153025829602309",
    "name": "jane",
    "nickName": "Jane Travels",
    "verified": false,
    "signature": "Travel vlogs & hacks",
    "bioLink": null,
    "avatar": "https://...",
    "privateAccount": false,
    "ttSeller": false,
    "following": 123,
    "fans": 120450,
    "heart": 2085000,
    "video": 215,
    "digg": 48
  },
  "musicMeta": {
    "musicName": "original sound",
    "musicAuthor": "jane",
    "musicOriginal": true,
    "musicAlbum": "",
    "playUrl": "https://...",
    "coverMediumUrl": "https://...",
    "musicId": "7568815657828125447"
  },
  "webVideoUrl": "https://www.tiktok.com/@jane/video/7268815616677661970",
  "mediaUrls": [
    "https://v16-webapp-prime.tiktok.com/video/...",
    "https://v19-webapp-prime.tiktok.com/video/..."
  ],
  "videoMeta": {
    "height": 1024,
    "width": 576,
    "duration": 17,
    "coverUrl": "https://...",
    "originalCoverUrl": "https://...",
    "definition": "540p",
    "format": "mp4",
    "originalDownloadAddr": "https://...",
    "downloadAddr": "https://..."
  },
  "diggCount": 4821,
  "shareCount": 132,
  "playCount": 178540,
  "collectCount": 324,
  "commentCount": 64,
  "mentions": [],
  "hashtags": [
    { "name": "foryoupage" },
    { "name": "travelhacks" }
  ]
}

Notes:

• Fields like musicMeta.musicAlbum and authorMeta.bioLink may be empty or null depending on the source video.
• Each dataset item includes the top-level “hashtag” indicating which input produced the result.

FAQ

Is there a free tier or trial?

Yes. This actor includes 120 trial minutes, so you can test the free TikTok hashtag scraper experience before subscribing. Usage beyond the trial follows the listed pricing.

Can I export results to CSV or JSON?

Yes. After a run completes, open the Apify dataset to export CSV or JSON. Many users use this TikTok hashtag extractor to export TikTok hashtags to CSV for analytics and reporting.

Can I run it with Python or via an API?

Yes. The actor is built in Python and runs on Apify. You can trigger it through the Apify API and integrate it with your TikTok hashtag scraper Python workflows.

Does it work for trending hashtags?

Yes. It collects videos currently available on TikTok tag pages, making it a practical TikTok trending hashtag scraper for monitoring trends over time.

What inputs are supported?

You can pass hashtags (without “#”), usernames (without “@”), keywords, or full TikTok URLs in startUrls. The actor normalizes them automatically.

How many results can I collect per hashtag?

Use maxData to control volume—between 1 and 1000 items per input. This supports both quick checks and large-scale TikTok hashtag crawler workflows.

Do I need to log in or provide cookies?

No. The scraper uses Playwright and does not require login for public hashtag pages.

What metrics and fields are included?

You get ids, captions, timestamps, engagement metrics (playCount, diggCount, shareCount, collectCount, commentCount), webVideoUrl, mediaUrls, plus authorMeta, musicMeta, videoMeta, and hashtags detected in the post.

Does it support proxies?

Yes. Configure proxyConfiguration as needed. If TikTok rejects a proxy, automatic fallback will occur.

Closing CTA / Final thoughts

Tiktok Hashtag Scraper is built to turn TikTok hashtag pages into clean, structured datasets for research, analytics, and growth. With reliable Playwright-powered collection, flexible inputs, and export-ready outputs, it helps marketers, developers, analysts, and researchers move from manual checks to automated insight.

Run it on Apify, export CSV/JSON, and plug the results into your dashboards or pipelines. Developers can trigger runs via API and build a TikTok hashtag API scraper into Python workflows. Start extracting smarter, trend-ready TikTok hashtag intelligence at scale.