Tiktok Trending Hashtags Analytics Scraper

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

Why Choose Us?

• 📊 Comprehensive Analytics: Get detailed analytics including video views, publish counts, rank changes, trend history, and industry categorization
• 🔍 Real-Time Data: Access TikTok's official trending hashtags directly from their Creative Center API
• 🌍 Multi-Country Support: Analyze hashtags for any country (US, GB, CA, etc.) with country-specific insights
• 📈 Trend Analysis: Track hashtag performance over time with historical trend data points
• 🏭 Industry Insights: Filter and analyze hashtags by industry categories for targeted market research
• 🛡️ 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 and industry-based filtering to get the exact data you need

Key Features

Analytics & Insights

• Engagement Metrics: Video views, publish counts, and rank positions
• Trend History: Historical trend data with time-series analysis
• Rank Tracking: Monitor rank changes (Up, Down, Stable, New) to identify emerging trends
• Industry Categorization: Filter and analyze hashtags by 19+ industry categories
• Country-Specific Analytics: Compare trending hashtags across different countries
• Period Analysis: Analyze trends over 7, 30, or 120-day periods

Technical 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
• Industry Filtering: Filter hashtags by industry category with fuzzy matching
• Deduplication: Automatically filters out duplicate hashtags
• Detailed Logging: Comprehensive logs with industry insights and diagnostics
• 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",
  "industry": "",
  "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"). Supports 46+ countries.
top100_period	string	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".
industry	string	No	""	Filter hashtags by industry category (optional). Leave empty to show all industries. Options include: News Entertainment, Education, Health, Vehicle Transportation, Sports Outdoor, Tech Electronics, Beauty Personal Care, Travel, Financial Services, Baby Kids Maternity, Games, Life Services, Pets, Household Products, Food Beverage, Home Improvement, Apparel Accessories, Business Services.
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 Analytics (US, 30 days, 100 hashtags)

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

Example 2: Industry-Specific Analytics (Games industry, sorted by views)

{
  "country": "US",
  "top100_period": "30",
  "total_hashtags": 100,
  "sort_order": "video_views",
  "industry": "Games"
}

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

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

Example 4: Multi-Country Comparison (UK, 7 days, News & Entertainment)

{
  "country": "GB",
  "top100_period": "7",
  "total_hashtags": 50,
  "industry": "News Entertainment"
}

Output

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

Output Schema

[
  {
    "hashtag_id": "7559694544908845112",
    "hashtag_name": "tiktokencyclopediacontest",
    "country_info": {
      "id": "US",
      "value": "United States",
      "label": "US"
    },
    "industry_info": {
      "id": 23000000000,
      "value": "News & Entertainment",
      "label": "label_23000000000"
    },
    "is_promoted": false,
    "trend": [
      {
        "time": 1760140800,
        "value": 0.08
      },
      {
        "time": 1760227200,
        "value": 0.07
      }
    ],
    "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 with id, value, and label (if available)
is_promoted	boolean	Whether the hashtag is promoted/advertised
trend	array	Array of trend data points with time (Unix timestamp) and value (normalized trend score) for historical analysis
publish_cnt	integer	Number of videos published with this hashtag (engagement metric)
video_views	integer	Total video views for this hashtag (engagement metric)
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"

Analytics Insights

The output data enables various analytics:

• Engagement Analysis: Compare video_views and publish_cnt across hashtags
• Trend Analysis: Use the trend array to visualize hashtag performance over time
• Rank Tracking: Monitor rank_change_readable to identify rising or falling hashtags
• Industry Comparison: Filter by industry_info to compare performance across industries
• Geographic Insights: Compare country_info to understand regional trends
• Promotion Detection: Use is_promoted to identify sponsored content

🚀 How to Use the Actor (via Apify Console)

1. Log in to Apify Console and navigate to Actors
2. Find the tiktok-trending-hashtags-analytics-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)
   • Optionally filter by industry category
   • 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, proxy status, and industry insights
6. Access results in the OUTPUT tab once the run completes
7. Export results to JSON or CSV format for further analysis
8. Analyze data using the comprehensive analytics fields provided

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,
    "industry": "Games"
  }'

Best Use Cases

📈 Market Research & Analytics

• Trend Analysis: Track trending hashtags across different countries and time periods to understand regional trends
• Industry Research: Filter by industry to analyze hashtag performance in specific sectors
• Competitive Intelligence: Monitor trending hashtags in your industry to stay ahead of competitors
• Market Segmentation: Compare hashtag trends across different countries for international market analysis

🎯 Content Strategy & Marketing

• Content Discovery: Identify popular hashtags in your niche to improve content discoverability
• Campaign Planning: Discover trending hashtags for campaign planning and audience targeting
• Engagement Optimization: Analyze video views and publish counts to understand engagement patterns
• Trend Prediction: Use rank change data to predict emerging trends before they peak

📊 Data Analysis & Reporting

• Performance Tracking: Track rank changes to see which hashtags are rising or falling in popularity
• Time-Series Analysis: Use trend data arrays to visualize hashtag performance over time
• Geographic Insights: Compare trending hashtags across different countries for international strategies
• Industry Benchmarking: Compare your industry's hashtag performance against others

🔍 Research & Insights

• Academic Research: Use data for social media research and trend analysis studies
• Brand Monitoring: Track hashtags related to your brand or industry
• Influencer Research: Identify trending hashtags used by influencers in your niche
• Cultural Analysis: Analyze hashtag trends to understand cultural shifts and interests

Analytics Features

Industry Filtering

Filter hashtags by industry category to get targeted insights:

• Available Industries: News Entertainment, Education, Health, Vehicle Transportation, Sports Outdoor, Tech Electronics, Beauty Personal Care, Travel, Financial Services, Baby Kids Maternity, Games, Life Services, Pets, Household Products, Food Beverage, Home Improvement, Apparel Accessories, Business Services
• Smart Matching: Fuzzy matching handles API variations (e.g., "News Entertainment" matches "News & Entertainment")
• Industry Insights: The actor logs available industries when filtering, helping you discover what's trending in each category

Trend Analysis

• Historical Data: Each hashtag includes a trend array with time-series data points
• Rank Tracking: Monitor rank_change_readable to identify emerging or declining trends
• Period Comparison: Compare 7, 30, and 120-day periods to understand short-term vs. long-term trends

Engagement Metrics

• Video Views: Total views across all videos using the hashtag
• Publish Count: Number of videos published with the hashtag
• Rank Position: Current position in trending rankings
• Promotion Status: Identify promoted/sponsored hashtags

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 40+ more countries...

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 considers multiple factors)
• video_views: Sorts hashtags by total video views (pure engagement metric)

How does industry filtering work?

The actor uses client-side filtering with fuzzy matching:

• Fetches all hashtags from the API
• Filters by industry category in Python code
• Handles API variations (e.g., "News Entertainment" matches "News & Entertainment")
• Shows available industries in logs when filtering
• Many hashtags may have empty industry_info and are excluded when filtering

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 analyze multiple countries, run the actor multiple times with different country codes and compare the results.

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
• Industry filtering (may require fetching more pages)

Typically, fetching 100 hashtags takes 1-3 minutes. With industry filtering, it may take longer as the actor fetches more pages to find matching hashtags.

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.

What industries are available?

The actor supports filtering by 19+ industry categories. However, not all industries may be available in trending hashtags for every country/period. The actor logs available industries when filtering, so you can see what's actually trending.

Common industries found in trending hashtags include:

• News & Entertainment
• Games
• Sports & Outdoor
• Beauty & Personal Care
• Food & Beverage
• Vehicle & Transportation
• Apparel & Accessories

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
• Analytics: Use the comprehensive output fields for your data analysis needs

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
• Industry Availability: Not all industries may be available in trending hashtags for every country/period. The actor will inform you of available industries when filtering.

---

Note: This actor is designed for legitimate research, marketing, analytics, and analysis purposes. Always respect TikTok's Terms of Service and applicable laws when using scraped data. Use the comprehensive analytics features to gain valuable insights into trending hashtags and social media trends.