tiktok-hashtag-videos

Extract paginated TikTok hashtag video lists with author, engagement, and music metadata.

5.5k|269|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/browser-act/skills --skill tiktok-hashtag-videos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tiktok-hashtag-videos
Source: https://github.com/browser-act/skills/tree/main/solutions/video-platforms/tiktok-hashtag-videos
Command: npx skills add https://github.com/browser-act/skills --skill tiktok-hashtag-videos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Collecting video data from a TikTok hashtag page manually is slow and impractical at scale, and TikTok's internal API requires dynamic request signing that blocks direct programmatic access. This Skill captures the signed API responses triggered by normal page navigation, returning structured video lists without manual copying.

Core Features & Use Cases

  • Challenge ID Resolution: Convert a hashtag name into its TikTok challenge ID along with total video and view counts via the challenge detail endpoint.
  • Paginated Video Extraction: Capture /api/challenge/item_list/ responses through browser navigation and scrolling, yielding roughly 30 videos per page with author profile, engagement stats, music, and video metadata.
  • Batch Hashtag Processing: Loop through multiple hashtags serially in one session with page-by-page result saving and error resumption.
  • Use Case: A marketing analyst researching the #fitness hashtag can extract hundreds of videos with play counts, creator follower stats, and music data to identify trending content and potential influencers.

Quick Start

Use the tiktok-hashtag-videos skill to scrape all videos under the TikTok hashtag fitness and return the full metadata list.

Frequently Asked Questions about tiktok-hashtag-videos

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape TikTok videos by hashtag?

Navigate to the TikTok hashtag page in a browser, then capture the /api/challenge/item_list/ network requests triggered by page load and scrolling. Each response contains about 30 videos with author, engagement, music, and video metadata.

How to get a TikTok challenge ID from a hashtag name?

Call the /api/challenge/detail/ endpoint with the hashtag name as the challengeName parameter. The response returns the challenge ID, canonical title, total video count, and total view count, and this endpoint works via direct fetch without signing.

Why does direct fetching of TikTok hashtag video lists return empty results?

The /api/challenge/item_list/ endpoint requires TikTok's dynamic request signing (X-Bogus/X-Gnarly), so direct fetch calls fail. You must navigate to the hashtag page and let TikTok's own JavaScript trigger the signed request, then capture it from network traffic.

Does TikTok hashtag scraping require login?

No login is required for public hashtag data. However, the browser must use a non-Hong-Kong proxy because TikTok has shut down service in Hong Kong, and private or age-restricted hashtags may return empty results.

What are the limitations of scraping TikTok hashtag videos?

Each scroll page returns only about 30 videos, so high-volume extraction requires many scroll iterations. Extraction also requires a non-HK proxy, and private or age-restricted hashtags may return empty item lists.