TikTok Hashtag Scraper avatar

TikTok Hashtag Scraper

Pricing

Pay per usage

Go to Apify Store
TikTok Hashtag Scraper

TikTok Hashtag Scraper

Meet the TikTok Hashtag Scraper! This actor quickly scrapes and downloads videos from any hashtag. It provides high-quality videos without watermarks. For the fastest possible download speeds, it is highly recommended to disable proxies. Get all the TikTok content you need, fast and clean.

Pricing

Pay per usage

Rating

5.0

(1)

Developer

Shahid Irfan

Shahid Irfan

Maintained by Community

Actor stats

1

Bookmarked

26

Total users

0

Monthly active users

11 days ago

Last modified

Features

Limited permissions

Share

What does TikTok Hashtag Scraper do?

TikTok Hashtag Scraper collects video details from TikTok hashtag pages. Enter one or more hashtags, and the Actor searches each hashtag, finds the videos shown there, and saves their public metadata to an Apify dataset.

The result is a structured list you can sort, filter, export, and connect to other tools. Each record tells you which hashtag produced the video, so a single run can cover several topics at once. Set the number of results wanted to control how many records the run saves.

Why use TikTok Hashtag Scraper?

  • Research hashtags in bulk - Add several hashtags in one run instead of opening each page by hand.
  • Structured output - Every video becomes one dataset row with consistent field names.
  • No video downloads - The Actor collects metadata only, so runs finish faster and use less storage.
  • Export ready - Download results as JSON, CSV, Excel, or XML, or read them through the Apify API.
  • Automation ready - Schedule runs to track hashtags over time or trigger workflows with webhooks.

What data can you extract from TikTok?

FieldDescription
hashtagHashtag that produced the video
video_idUnique TikTok video identifier
titleVideo caption or title
authorTikTok username of the creator
publish_dateUpload date in YYYYMMDD format
durationVideo length in seconds
view_countNumber of views
like_countNumber of likes
descriptionFull video description
thumbnailThumbnail image URL
urlDirect TikTok video URL
collected_atISO timestamp for when the record was saved

How to use TikTok Hashtag Scraper

  1. Open the Actor on Apify Store.
  2. Add one or more hashtags without the # symbol.
  3. Set the number of results wanted and, if needed, a proxy configuration.
  4. Run the Actor.
  5. Open the dataset to review the videos and their metadata.
  6. Download the dataset or connect it to your workflow.

A hashtag can contain letters, numbers, and underscores. Spaces, punctuation, and the # symbol are not required and are cleaned from valid entries. Invalid hashtags stop the run with a clear validation message.

Input Parameters

ParameterTypeRequiredDefaultDescription
hashtagsArray of stringsNo["funny"]Hashtags to search, without the # symbol
resultsWantedIntegerNo20Maximum video records to save across all hashtags
proxyConfigurationObjectNo{}Proxy settings. Empty means no proxy. Choose Apify Proxy or add custom proxy URLs in the form

Hashtags are optional because the Actor has a default example. Add your own list to replace it. The Actor always collects metadata and does not download video files.

Output Data

FieldTypeDescription
hashtagStringHashtag that produced the video
video_idStringUnique TikTok video identifier
titleStringVideo caption or title
authorStringCreator username
publish_dateStringUpload date in YYYYMMDD format
durationNumberVideo length in seconds
view_countNumberViews at collection time
like_countNumberLikes at collection time
descriptionStringFull video description
thumbnailStringThumbnail image URL
urlStringDirect TikTok video URL
collected_atStringISO timestamp for when the record was saved

Only public videos are saved. If a video is private, restricted, or no longer available, it is skipped and the run continues. The final log line reports how many videos were skipped.

TikTok's public hashtag page exposes a limited set of videos. If fewer videos are available than resultsWanted, the Actor also checks TikTok's topic page for the same hashtag, merges any new videos, and logs when no more public videos are returned.

Usage Examples

Search one hashtag

Collect up to 50 videos from a single hashtag page:

{
"hashtags": ["funny"],
"resultsWanted": 50
}

Search several hashtags

Collect videos from multiple topics in the same run:

{
"hashtags": ["funny", "cats", "cooking"],
"resultsWanted": 100
}

Use Apify Proxy

Proxy is off by default. Turn it on from the Proxy configuration field when you need a different network exit:

{
"hashtags": ["funny"],
"resultsWanted": 20,
"proxyConfiguration": {
"useApifyProxy": true
}
}

Mixed casing and prefixes

Hashtags are normalized to lowercase, and a leading # is accepted:

{
"hashtags": ["#FYP", "StreetFood", "dance_challenge"],
"resultsWanted": 30
}

Sample Output

{
"hashtag": "funny",
"video_id": "7706305917662268703",
"title": "When the joke lands at the wrong time #funny #comedy",
"author": "example_creator",
"publish_date": "20260728",
"duration": 23,
"view_count": 1854000,
"like_count": 142300,
"description": "When the joke lands at the wrong time #funny #comedy",
"thumbnail": "https://p16-sign-va.tiktokcdn.com/example-thumbnail.jpg",
"url": "https://www.tiktok.com/@example_creator/video/7706305917662268703",
"collected_at": "2026-07-28T10:30:00+00:00"
}

Tips for Best Results

  • Use popular hashtags. Hashtags with little or no public content return an empty dataset.
  • Set resultsWanted to the number of records you need. The cap applies across all hashtags in the run.
  • Keep the list focused. A run processes videos for each hashtag until the result cap is reached.
  • Videos that appear under more than one of your hashtags are saved once.
  • Leave proxy off for the fastest run. Enable it only when you need a different network exit.
  • View, like, and publish values reflect what TikTok returned when the record was collected.
  • If a hashtag returns no videos, try it again later or test a broader hashtag.
  • Missing fields are a source limitation. Not every video publishes every value.

Integrations

  • Google Sheets - Send dataset rows to a spreadsheet for review and reporting.
  • Webhooks - Trigger a workflow when a run finishes.
  • Make or Zapier - Connect results to no-code automations.
  • API - Read datasets programmatically from your own systems.
  • Apify schedules - Re-run selected hashtags hourly, daily, or weekly.

Frequently Asked Questions

Does this Actor download TikTok videos?

No. It collects public video metadata only. The dataset does not include video files or download links.

Can I search more than one hashtag in a single run?

Yes. Add each hashtag to the hashtags array. Every hashtag is searched, and each saved record names the hashtag that produced it.

How many videos does one hashtag return?

The resultsWanted value caps the total number of records saved in the run. TikTok's public hashtag page only exposes a limited set of videos, so the Actor also checks TikTok's topic page for the same hashtag and merges new videos. If the cap still is not reached, it saves everything it found and logs that no more public videos were returned.

Why is the dataset empty?

The hashtag may have no public videos, may be restricted, or TikTok may have returned a page without video links. Try a more popular hashtag or run the Actor again later.

Is a proxy required?

No. Proxy is off by default. The Actor fetches public hashtag pages without one. If you enable proxy and the proxy returns no videos, the Actor retries the hashtag without it.

What happens to private or unavailable videos?

They are skipped. The dataset contains only public video details, and the final log reports how many videos were skipped during the run.

Why are some fields empty?

TikTok does not publish every value for every video. A missing view, like, or thumbnail value is reported as an empty field rather than invented.

Can I export the data to CSV or Excel?

Yes. Apify datasets can be downloaded in CSV, Excel, JSON, XML, and other supported formats after a run.

Can I run this Actor on a schedule?

Yes. Create a schedule in Apify Console and choose the input hashtags. Scheduled runs keep a history of results in separate datasets.

Collecting publicly available data can be legal, but rules differ by location and use case. You are responsible for complying with applicable laws, TikTok's terms, and privacy requirements.

Support

For issues, feature requests, or custom Actor work, use the Issues tab on the Actor page or contact the developer through Apify.

This Actor is designed for legitimate collection of publicly available data. Users are responsible for using the data responsibly and complying with applicable laws and website terms.