Tiktok Trending Hashtags Scraper

A powerful Apify actor that scrapes trending TikTok hashtags from the TikTok Creative Center API. Get real-time data on the most popular hashtags by country, time period, and engagement metrics. Perfect for market research, content strategy, and trend analysis.

Why Choose Us?

• 🔍 Real-Time Data: Access TikTok's official trending hashtags directly from their Creative Center API
• 🌍 Multi-Country Support: Scrape hashtags for any country (US, GB, CA, etc.)
• 📊 Comprehensive Metrics: Get detailed data including video views, publish counts, rank changes, and trend history
• 🛡️ Smart Proxy Management: Automatic proxy fallback system ensures reliable data collection
• ⚡ Efficient Pagination: Automatically handles pagination to fetch large datasets
• 🎯 Flexible Filtering: Multiple filter strategies to ensure you get the data you need

Key Features

• Dynamic Header Extraction: Uses Playwright to extract authentic headers from TikTok's Creative Center
• Intelligent Proxy Fallback:
  • Starts with direct connection (no proxy)
  • Automatically falls back to datacenter proxy if blocked
  • Falls back to residential proxy if datacenter fails
  • Retries up to 3 times with residential proxy
  • Sticks with working proxy for all remaining requests
• Multiple Time Periods: Choose from 7, 30, or 120-day trending periods
• Flexible Sorting: Sort by popularity or video views
• Deduplication: Automatically filters out duplicate hashtags
• Detailed Logging: Comprehensive logs keep you informed throughout the scraping process
• Structured Output: Clean, consistent JSON format matching TikTok's API structure

Input

The actor accepts the following input parameters:

Input Schema

{
  "result_type": "top100",
  "country": "US",
  "top100_period": 30,
  "total_hashtags": 100,
  "sort_order": "popular",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Input Parameters

Parameter	Type	Required	Default	Description
result_type	string	No	"top100"	Type of results to fetch. Currently supports "top100" only.
country	string	No	"US"	Country code for trending hashtags (e.g., "US", "GB", "CA", "AU").
top100_period	integer	No	30	Time period in days. Valid options: 7, 30, or 120.
total_hashtags	integer	No	100	Total number of hashtags to fetch. Minimum: 1, Maximum: 500.
sort_order	string	No	"popular"	How to sort the hashtags. Options: "popular" or "video_views".
proxyConfiguration	object	No	{"useApifyProxy": false}	Proxy configuration. By default, no proxy is used. If TikTok blocks requests, the actor automatically falls back to datacenter, then residential proxies.

Input Examples

Example 1: Basic Usage (US, 30 days, 100 hashtags)

{
  "country": "US",
  "top100_period": 30,
  "total_hashtags": 100
}

Example 2: UK Trending Hashtags (7 days, sorted by views)

{
  "country": "GB",
  "top100_period": 7,
  "total_hashtags": 50,
  "sort_order": "video_views"
}

Example 3: Long-term Trends (120 days, with proxy)

{
  "country": "CA",
  "top100_period": 120,
  "total_hashtags": 200,
  "sort_order": "popular",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Output

The actor outputs an array of hashtag objects, each containing comprehensive trending data.

Output Schema

[
  {
    "hashtag_id": "7559694544908845112",
    "hashtag_name": "tiktokencyclopediacontest",
    "country_info": {
      "id": "US",
      "value": "United States",
      "label": "US"
    },
    "industry_info": {},
    "is_promoted": false,
    "trend": [
      {
        "time": 1760140800,
        "value": 0
      }
    ],
    "publish_cnt": 12345,
    "video_views": 9876543,
    "rank": 1,
    "rank_diff_type": 1,
    "period": "30",
    "rank_change_readable": "Up"
  }
]

Output Fields

Field	Type	Description
hashtag_id	string	Unique identifier for the hashtag
hashtag_name	string	The hashtag name (without #)
country_info	object	Country information containing id, value, and label
industry_info	object	Industry categorization (if available)
is_promoted	boolean	Whether the hashtag is promoted/advertised
trend	array	Array of trend data points with time (Unix timestamp) and value
publish_cnt	integer	Number of videos published with this hashtag
video_views	integer	Total video views for this hashtag
rank	integer	Current ranking position (1 = most popular)
rank_diff_type	integer	Rank change indicator: 0 = No Change, 1 = Up, 2 = Down, 3 = Stable, 4 = New
period	string	Time period in days ("7", "30", or "120")
rank_change_readable	string	Human-readable rank change: "No Change", "Up", "Down", "Stable", "New"

Output Example

[
  {
    "hashtag_id": "7559694544908845112",
    "hashtag_name": "tiktokencyclopediacontest",
    "country_info": {
      "id": "US",
      "value": "United States",
      "label": "US"
    },
    "industry_info": {},
    "is_promoted": false,
    "trend": [
      {
        "time": 1760140800,
        "value": 0
      },
      {
        "time": 1760227200,
        "value": 0
      }
    ],
    "publish_cnt": 12345,
    "video_views": 9876543,
    "rank": 1,
    "rank_diff_type": 1,
    "period": "30",
    "rank_change_readable": "Up"
  }
]

🚀 How to Use the Actor (via Apify Console)

1. Log in to Apify Console and navigate to Actors
2. Find the tiktok-trending-hashtags-scraper actor and click on it
3. Configure inputs:
   • Set your target country code (e.g., US, GB, CA)
   • Choose the time period (7, 30, or 120 days)
   • Set the number of hashtags to fetch (1-500)
   • Select sort order (popular or video_views)
   • Configure proxy settings if needed (default: no proxy)
4. Run the actor by clicking the "Start" button
5. Monitor logs in real-time to see progress and proxy status
6. Access results in the OUTPUT tab once the run completes
7. Export results to JSON or CSV format for further analysis

Running via API

curl -X POST "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "US",
    "top100_period": 30,
    "total_hashtags": 100
  }'

Best Use Cases

• 📈 Market Research: Track trending hashtags across different countries and time periods to understand regional trends
• 🎯 Content Strategy: Identify popular hashtags in your niche to improve content discoverability
• 📊 Trend Analysis: Analyze hashtag performance over time using the trend data array
• 🔍 Competitive Intelligence: Monitor trending hashtags in your industry to stay ahead of competitors
• 📱 Social Media Marketing: Discover trending hashtags for campaign planning and audience targeting
• 📉 Performance Tracking: Track rank changes to see which hashtags are rising or falling in popularity
• 🌍 Global Insights: Compare trending hashtags across different countries for international marketing strategies

Frequently Asked Questions

How does the proxy fallback system work?

The actor starts with no proxy (direct connection). If TikTok blocks or rejects a request:

1. It automatically falls back to a datacenter proxy
2. If datacenter fails, it falls back to a residential proxy
3. If residential fails, it retries up to 3 times with new residential proxy URLs
4. Once a proxy is working, it sticks with that proxy for all remaining requests

All proxy changes are logged clearly in the actor logs.

What countries are supported?

Any country code supported by TikTok's Creative Center API. Common examples include:

• US (United States)
• GB (United Kingdom)
• CA (Canada)
• AU (Australia)
• DE (Germany)
• FR (France)
• And many more...

How many hashtags can I fetch?

You can fetch between 1 and 500 hashtags per run. The actor uses intelligent pagination and multiple filter strategies to ensure you get the requested number of hashtags.

What's the difference between "popular" and "video_views" sort order?

• popular: Sorts hashtags by overall popularity (TikTok's algorithm)
• video_views: Sorts hashtags by total video views

How accurate is the data?

The data comes directly from TikTok's official Creative Center API, ensuring accuracy and reliability. The actor extracts dynamic headers to maintain API compatibility.

Can I scrape multiple countries in one run?

Currently, the actor supports one country per run. To scrape multiple countries, run the actor multiple times with different country codes.

What happens if TikTok blocks my requests?

The actor's intelligent proxy fallback system automatically handles blocks:

• Logs the block clearly
• Switches to datacenter proxy
• If needed, switches to residential proxy
• Retries up to 3 times with residential proxy
• Continues with the working proxy for remaining requests

How long does a run take?

Run time depends on:

• Number of hashtags requested
• Network speed and proxy performance
• TikTok API response times

Typically, fetching 100 hashtags takes 1-3 minutes.

Is there rate limiting?

The actor includes built-in delays between requests (0.5 seconds) to avoid rate limiting. If you encounter rate limits, the proxy fallback system will help bypass them.

Support and Feedback

• Issues: Report bugs or request features through the Apify platform
• Documentation: Check the actor's input/output schema in the Apify Console
• Updates: The actor is regularly updated to maintain compatibility with TikTok's API

Cautions

• Public Data Only: This actor collects data only from publicly available sources on TikTok's Creative Center
• Rate Limits: While the actor includes rate limiting protection, excessive use may trigger TikTok's rate limits
• API Changes: TikTok may update their API, which could temporarily affect the actor's functionality
• Legal Compliance: Users are responsible for ensuring their use of this data complies with applicable laws, including:
  • Data protection regulations (GDPR, CCPA, etc.)
  • Terms of service of TikTok
  • Local privacy and data scraping laws
• Ethical Use: Use this data responsibly and ethically. Do not use scraped data for spam, harassment, or other malicious purposes
• No Private Data: The actor does not access private accounts, password-protected content, or personal information beyond what is publicly available

---

Note: This actor is designed for legitimate research, marketing, and analysis purposes. Always respect TikTok's Terms of Service and applicable laws when using scraped data.