Tiktok Hashtag Scraper

Tiktok Hashtag Scraper

Tiktok Hashtag Scraper is a production-ready Apify actor that extracts videos and analytics from TikTok hashtag pages — including captions, views, likes, comments, shares, author details, sounds, publish dates, and more. As a TikTok hashtag extractor and TikTok hashtag scraper tool, it solves the tedious task of manual research by turning any hashtag into structured, analytics-ready data for marketers, developers, data analysts, and researchers. At scale, you can export results to CSV/JSON or via API to power a TikTok hashtag research tool, dashboards, and automated workflows.

What data / output can you get?

The actor pushes structured JSON records to the Apify dataset with the following fields. Below are examples of the exact keys and sample values you can expect:

Data type (field)	Description	Example value
hashtag	Input token the item belongs to	"travel"
id	Video ID	"7568815616677661970"
text	Video caption/description	"Sunset road trip across the coast 🌅🚗"
createTimeISO	Video publish time in ISO format	"2025-11-04T16:30:16Z"
webVideoUrl	Public TikTok URL to the video	"https://www.tiktok.com/@creator/video/7568815616677661970"
authorMeta.name	Author’s unique username	"jannatthelunatictraveler"
authorMeta.fans	Author follower count	12000
musicMeta.musicName	Track title	"original sound"
videoMeta.duration	Video length in seconds	176
playCount	View count	176800
diggCount	Like count	4947
commentCount	Comment count	62

Bonus outputs included per item:

• Full authorMeta (id, nickName, verified, signature, avatar, privateAccount, ttSeller, following, fans, heart, video, digg)
• Full musicMeta (musicAuthor, musicOriginal, musicAlbum, playUrl, coverMediumUrl, musicId)
• Full videoMeta (height, width, coverUrl, originalCoverUrl, definition, format, originalDownloadAddr, downloadAddr)
• mediaUrls (array of playable/download URLs)
• hashtags (array of objects with name)
• createTime (UNIX timestamp), isAd, isMuted, mentions (array)

You can export the dataset to JSON, CSV, or Excel, or consume it directly via the Apify API — ideal for a TikTok trending hashtag scraper, TikTok hashtag finder, or TikTok hashtag analytics pipelines.

Key features

• 🔍 Playwright-powered hashtag crawler
  Reliable, headless Chromium automation captures real API responses behind TikTok tag pages for resilient scraping.

• 📦 Bulk scraping & scale
  Feed an array of inputs to startUrls for a bulk TikTok hashtag scraper workflow. The actor processes multiple hashtags in parallel for faster throughput.

• 📊 Structured analytics fields
  Collect engagement metrics (playCount, diggCount, shareCount, commentCount) with author, music, and video metadata — perfect for TikTok hashtag data mining and TikTok hashtag analytics.

• 🌐 Proxy configuration with fallback
  Configure proxyConfiguration to control networking. If TikTok rejects a proxy, automatic fallback is applied per the input schema description.

• 💾 Export-ready dataset
  Results land in an Apify dataset you can export as JSON/CSV/Excel or access via API — a great fit for a TikTok hashtag API scraper or downstream BI tools.

• 👨‍💻 Developer friendly
  Integrate via the Apify API or SDK from Python/JavaScript to build pipelines, run scheduled jobs, and embed a TikTok hashtag crawler in your data stack.

• 🛡️ Production reliability
  Pagination and deduplication logic, plus robust scrolling strategies, make this a dependable TikTok hashtag search scraper for ongoing operations.

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. Find the actor
   Search for “Tiktok Hashtag Scraper” and open the actor page.

3. Add input data
   In startUrls, paste a list of hashtags (without #), usernames (without @), or keywords as plain strings. Example: ["travel", "fitness", "cooking"].

4. Configure options

   • maxData: Set how many videos to collect per input (default 10; range 1–1000).
   • proxyConfiguration: Choose proxies as needed; automatic fallback will occur if a proxy is rejected.

5. Run the actor
   Click Start. The scraper will browse TikTok tag pages and collect structured results for each input.

6. Review and export results
   Open the run dataset to preview items (ID, caption, created time, URL, author, likes, shares, views, comments). Export to JSON, CSV, or Excel, or fetch via API.

Pro tip: Orchestrate this TikTok hashtag extractor with schedules and webhooks, or pull results programmatically to your warehouse to build a TikTok competitor hashtag scraper or analytics dashboard.

Use cases

Use case name	Description
Marketing teams — trend tracking	Identify rising tags and measure performance (views, likes, comments) to improve campaign ROI.
Social media managers — content planning	Discover effective hashtags to increase reach and engagement for upcoming posts.
Competitor & influencer research	Analyze which tags competitors and creators use, and benchmark engagement.
E‑commerce — product discovery	Find product-related hashtags to inform TikTok Shop promotions and creative direction.
Data analysts — hashtag analytics	Build datasets for modeling virality, topic clusters, and performance baselines.
Developers — API pipelines	Automate a TikTok hashtag API scraper workflow using Apify datasets and SDKs.
Academic & trend research	Study hashtag diffusion, creator networks, and cultural trends using structured time-stamped data.

Why choose Tiktok Hashtag Scraper?

This actor delivers precision, structure, and reliability for TikTok hashtag research at scale.

• ⚡ Accurate, structured output with rich metadata for analysis-ready datasets
• 📈 Built for scale: handle many inputs in one run for bulk TikTok hashtag scraper operations
• 💻 Developer access via Apify API/SDK for Python/JavaScript integrations
• 🌐 Safe, public-data approach with configurable proxyConfiguration and fallback
• 💾 Instant exports to JSON/CSV/Excel for easy reporting and ETL
• 🧩 Works better than fragile browser extensions — production-grade Playwright automation

In short, it’s a robust TikTok hashtag scraper tool that outperforms ad‑hoc solutions and unstable alternatives.

Is it legal / ethical to use Tiktok Hashtag Scraper?

Yes — when used responsibly. This actor targets publicly available TikTok hashtag pages and video metadata.

Guidelines for compliant use:

• Only collect public information from hashtag pages and public videos.
• Respect TikTok’s Terms of Service and platform policies.
• Avoid scraping private or restricted data and do not attempt to bypass authentication.
• Ensure your use complies with applicable regulations (e.g., GDPR, CCPA).
• Consult your legal team for specific use cases or jurisdictions.

Input parameters & output format

Example JSON input

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

Parameters

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

Example JSON output

{
  "hashtag": "travel",
  "id": "7568815616677661970",
  "text": "Sunset road trip across the coast 🌅🚗",
  "createTime": 1762252216,
  "createTimeISO": "2025-11-04T16:30:16Z",
  "isAd": false,
  "isMuted": false,
  "authorMeta": {
    "id": "7028153025829602309",
    "name": "jannatthelunatictraveler",
    "nickName": "Jannat",
    "verified": false,
    "signature": "Travel Vlogger || Travel Film Maker",
    "bioLink": null,
    "avatar": "https://p16-sign-va.tiktokcdn.com/...",
    "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://sf16-ies-music-sg.tiktokcdn.com/...",
    "coverMediumUrl": "https://p16-sign-va.tiktokcdn.com/...",
    "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://p16-sign-va.tiktokcdn.com/...",
    "originalCoverUrl": "https://p16-sign-va.tiktokcdn.com/...",
    "definition": "540p",
    "format": "mp4",
    "originalDownloadAddr": "https://v16-webapp-prime.tiktok.com/video/...",
    "downloadAddr": "https://v16-webapp-prime.tiktok.com/video/..."
  },
  "diggCount": 4947,
  "shareCount": 1384,
  "playCount": 176800,
  "collectCount": 1705,
  "commentCount": 62,
  "mentions": [],
  "hashtags": [
    { "name": "foryoupage" },
    { "name": "viralreels" },
    { "name": "bangladesh" }
  ]
}

Notes:

• Each item includes the input "hashtag" key for traceability.
• Some nested fields may be empty when TikTok doesn’t provide them (e.g., bioLink, musicAlbum).
• The default dataset view highlights: hashtag, id, text, createTimeISO, webVideoUrl, authorMeta.name, authorMeta.fans, diggCount, shareCount, playCount, commentCount.

FAQ

Is there a free trial?

Yes. This actor offers a trial period on Apify with 120 trial minutes, letting you evaluate the TikTok tags scraper workflow before subscribing.

Do I need to log in to TikTok?

No. The scraper targets publicly available hashtag pages and videos using headless Chromium; no login or cookies are required.

Can I scrape multiple hashtags in bulk?

Yes. Provide an array of values in startUrls to run a bulk TikTok hashtag scraper, and control volume per input with maxData.

What data fields are included in the output?

Each item contains video identifiers and metadata (id, text, createTime/ISO), authorMeta, musicMeta, videoMeta, engagement metrics (playCount, diggCount, shareCount, commentCount, collectCount), mediaUrls, hashtags, and webVideoUrl, plus the input hashtag.

Does it support proxies?

Yes. Use proxyConfiguration to choose proxies. If a proxy is rejected by TikTok, an automatic fallback will occur as described in the input schema.

How many results can I get per hashtag?

Set maxData from 1 to 1000 (default 10). The actor will paginate and collect up to that many videos per input.

Can developers use it via API or Python?

Yes. Access results via the Apify API and SDKs to build a TikTok hashtag API scraper pipeline for data lakes, dashboards, or downstream apps.

Can I input hashtags, usernames, or keywords?

Yes. startUrls accepts hashtags (without #), usernames (without @), or keywords as plain strings, making it versatile for TikTok hashtag search scraper workflows.

Final thoughts

Tiktok Hashtag Scraper is built to turn TikTok hashtag pages into clean, structured datasets for trend tracking and analysis. With bulk input support, rich engagement and metadata fields, proxy control, and export via JSON/CSV/Excel or API, it’s ideal for marketers, developers, data analysts, and researchers. Plug it into your automation stack as a TikTok hashtag generator with scraping capabilities, or build a full TikTok hashtag crawler pipeline — start extracting smarter insights today.