#️⃣ TikTok Hashtag Posts Scraper

Extract TikTok videos associated with specific hashtags! This powerful tool helps you gather in-depth information about videos using particular hashtags, including engagement metrics, video details, and creator information.

✨ Key Features

• 📥 Get hashtag videos with flexible filters
• 📊 Get detailed video metadata including:
  • Video information and statistics
  • Engagement metrics
  • Music details
  • Author information
  • Creation timestamps
  • Video URLs
• 🔗 Generate direct URLs for:
  • Video content
  • Music tracks
  • User profiles
• 📈 Support for large result sets with automatic pagination
• 📋 Clean and structured JSON output

💪 Why Choose This Actor?

• Comprehensive: Get all video details from hashtag
• Flexible: Multiple search filters and parameters
• Efficient: Automatic pagination for large result sets
• Structured: Clean JSON output for easy integration
• Reliable: Stable and consistent data extraction
• User-Friendly: Simple input parameters

🎯 Perfect For

• �� Content Analysts
• 🎯 Social Media Managers
• 📱 Content Creators
• Market Researchers
• Trend Analysts
• Brand Managers

📈 Use Cases

1. Trend Analysis: Study hashtag performance
2. Content Research: Find trending videos
3. Campaign Tracking: Monitor hashtag campaigns
4. Engagement Study: Track video performance
5. Content Strategy: Research successful content

📝 Input Requirements

The actor accepts the following input parameters:

• challenge_id (optional): The hashtag's ID
• keyword (optional): The hashtag keyword (either challenge_id or keyword must be provided)
• maxResults (optional): Maximum number of videos to extract (default: 10)
• region (optional): Region code (default: US)

Input Example

{
  "keyword": "dance",
  "maxResults": 20,
  "region": "US"
}

Output Example

[
  {
    "aweme_id": "v12044gd0000d0hujgnog65i99bfqeeg",
    "video_id": "7504099296120163627",
    "region": "US",
    "title": "mismatch* #l#linedancingb#bootsd#dance",
    "cover": "https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/ogEirKaplcOu4SdlxbIgg9vCBAjEiwBM6yUPI~tplv-tiktokx-origin.image?dr=8593&refresh_token=0ae00ddf&x-expires=1747285200&x-signature=sSmazmJL1KAN%2FNax%2FuBkZaMF68o%3D&t=bacd0480&ps=933b5bde&shp=d05b14bd&shcp=c0f880ed&idc=useast5&s=CHALLENGE_AWEME&sc=cover&biz_tag=tt_video",
    "ai_dynamic_cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-p-0068-tx/oEwa24PBYjpUtrCSiiHvCIIAyb6ll9BBOAEdg~tplv-tiktokx-origin.image?dr=8606&refresh_token=11b2c949&x-expires=1747285200&x-signature=C6bc8GdMPS%2BbeSdBz7HO0DZtL%2BE%3D&t=bacd0480&ps=4f5296ae&shp=d05b14bd&shcp=c0f880ed&idc=useast5&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=dynamic_cover",
    "origin_cover": "https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-p-0068-tx/o8XjQAy9bUvEwCGiPlrdSO46BDIagibp0BAAI~tplv-tiktokx-360p.webp?dr=8600&refresh_token=c25106af&x-expires=1747285200&x-signature=7TB1bukc25Dqtr1fGdc7p1OCEVI%3D&t=bacd0480&ps=d97f9a4f&shp=d05b14bd&shcp=c0f880ed&idc=useast5&biz_tag=tt_video&s=CHALLENGE_AWEME&sc=feed_cover",
    "duration": 15,
    "play": "https://v16m.tiktokcdn-us.com/e867007c22cef68b6950f60dec574564/68247dfa/video/tos/useast5/tos-useast5-ve-0068c001-tx/o4viaQA4BliIBPAjEdEIE9sbgSO56wpiryCUL/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=4506&bt=2253&cs=0&ds=6&ft=arR-Iqq2m0nPD12.IvYT3wUexY8daeF~O5&mime_type=video_mp4&qs=0&rc=PGU1ODM5NWc0NjM5NDNnaEBpamhpPGw5cmp4MzMzZzczNEA0NjFjMzIyXjQxLl8yXi4yYSNibl82MmRrZ2VhLS1kMS9zcw%3D%3D&vvpl=1&l=202505140526357808E88B60A56702D27D&btag=e000b8000",
    "wmplay": "https://v16m.tiktokcdn-us.com/c924a78ea39d539d240983ec2f50a40b/68247dfa/video/tos/useast5/tos-useast5-ve-0068c001-tx/oQxE316WQlkIkRRCcH2DfH6jnCAFgQeAIeGQIK/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=13&dr=0&er=0&lr=all&net=0&cd=0%7C0%7C0%7C&cv=1&br=4512&bt=2256&cs=0&ds=3&ft=arR-Iqq2m0nPD12.IvYT3wUexY8daeF~O5&mime_type=video_mp4&qs=0&rc=OjVlNTg6ZGVoOWc2aWhmZEBpamhpPGw5cmp4MzMzZzczNEA2NS4uYjIwXzUxLy9eY18xYSNibl82MmRrZ2VhLS1kMS9zcw%3D%3D&vvpl=1&l=202505140526357808E88B60A56702D27D&btag=e000b8000",
    "size": 4325970,
    "wm_size": 4331726,
    "music": "https://v16m.tiktokcdn-us.com/19e7702b858a6bdaebd6a9a36a933349/6824d2c3/video/tos/useast5/tos-useast5-ve-2774-tx/be27b4dac58f42169251467472a63962/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=128&bt=64&ft=GSDrKInz7Th1GHQKXq8Zmo&mime_type=audio_mp4&qs=3&rc=N2k1NmY5Zzw7NTw8OTc6aEBpajdlbGQ6Znc5ZTMzODlkNEBhMWIuYzJjNl4xYi00YTM0YSNqZHJjcjQwMzZgLS1kYS1zcw%3D%3D&vvpl=1&l=202505140526357808E88B60A56702D27D&btag=e00090000&shp=d05b14bd&shcp=-",
    "music_info": {
      "id": "6781963030553954306",
      "title": "Damn I Love Miami",
      "play": "https://v16m.tiktokcdn-us.com/19e7702b858a6bdaebd6a9a36a933349/6824d2c3/video/tos/useast5/tos-useast5-ve-2774-tx/be27b4dac58f42169251467472a63962/?a=1233&bti=NXYpNDs8QGo6OjZAOm00NTAuYCMxNDNg&ch=0&cr=0&dr=0&er=0&lr=default&cd=0%7C0%7C0%7C0&br=128&bt=64&ft=GSDrKInz7Th1GHQKXq8Zmo&mime_type=audio_mp4&qs=3&rc=N2k1NmY5Zzw7NTw8OTc6aEBpajdlbGQ6Znc5ZTMzODlkNEBhMWIuYzJjNl4xYi00YTM0YSNqZHJjcjQwMzZgLS1kYS1zcw%3D%3D&vvpl=1&l=202505140526357808E88B60A56702D27D&btag=e00090000&shp=d05b14bd&shcp=-",
      "cover": "https://p16-common-sg.tiktokcdn-us.com/tos-alisg-v-2774/60d3c943cbac4f13a825cc049420d3c1~tplv-tiktokx-cropcenter:720:720.jpeg?dr=9584&t=4d5b0474&ps=933b5bde&shp=08d74b56&shcp=d05b14bd&idc=useast5",
      "author": "Pitbull & Lil Jon",
      "original": false,
      "duration": 60,
      "album": "Bad Boys For Life Soundtrack"
    },
    "play_count": 102267,
    "digg_count": 15573,
    "comment_count": 57,
    "share_count": 52,
    "download_count": 20,
    "collect_count": 475,
    "create_time": 1747184303,
    "anchors": null,
    "anchors_extras": "",
    "is_ad": false,
    "commerce_info": {
      "adv_promotable": false,
      "auction_ad_invited": false,
      "branded_content_type": 0,
      "with_comment_filter_words": false
    },
    "commercial_video_info": "",
    "item_comment_settings": 0,
    "mentioned_users": "",
    "author": {
      "id": "6729960039426573317",
      "unique_id": "emilysentner",
      "nickname": "Emily",
      "avatar": "https://p16-pu-useast8.tiktokcdn-us.com/tos-useast5-avt-0068-tx/0fbebaf8f0cc68f64cf0674beb478596~tplv-tiktokx-cropcenter-q:300:300:q75.jpeg?dr=8834&idc=useast5&ps=87d6e48a&s=CHALLENGE_AWEME&sc=avatar&shcp=c0f880ed&shp=45126217&t=223449c4"
    },
    "is_top": 0,
    "scrapedAt": "2025-05-14T05:26:36.915Z"
  },
  ...
]