Skip to content
    ↑↓ to choose · Enter to open

    · 12 min read

    TikTok Hashtag Trends Scraper: Up to 1,000 Free Results a Month (2026)

    By CrawlerBros Engineering Team

    Each record carries 9 output fields, including hashtag identifiers, video view counts, and a time-series popularity curve capturing trend momentum across custom observation windows. Operating without cookies or account credentials, this data collector targets TikTok Creative Center endpoints to return structured hashtag metrics for specific geographic markets. Apify's free plan covers up to 1,000 results of this Actor, and a first run costs at most $0.015 in result charges when using the default cap of 3 items. Built for growth marketers and social media analysts who need regional trend intelligence, this tool is not for anyone who requires historical depth beyond 180 days or full-scale feed scraping without public endpoint constraints.

    Try it: open TikTok Hashtag Trends Scraper on Apify, sign in on the free plan and run the prefilled example.

    Yes. Apify's free plan includes $5.00 of prepaid usage every month and asks for no credit card. At $0.005 per result, that covers up to 1,000 results of TikTok Hashtag Trends Scraper a month, before run-start charges and platform usage.

    The example request further down caps maxRanks at 3, so a first run returns at most 3 results and costs at most $0.015 in result charges. That is enough to see the real shape of the data before deciding anything.

    TikTok Hashtag Trends Scraper was last updated on 2026-06-30. It is one of 1,725 Actors CrawlerBros publishes on Apify, which together have 668,977 lifetime public runs and an average rating of 4.63 out of 5 across 416 reviews.

    Each result costs $0.005 on Apify's free plan, which is $5.00 per 1,000 results. Starting a run is charged separately at $0.005 per GB of Actor memory. Apify also bills the platform usage each run consumes, at the rates of your Apify plan, on top of these charges.

    Apify plan Per result Per 1,000 results
    FREE $0.005 $5.00
    BRONZE $0.00433 $4.33
    SILVER $0.00367 $3.67
    GOLD $0.003 $3.00
    PLATINUM $0.003 $3.00
    DIAMOND $0.003 $3.00

    The primary cost driver is the maxRanks control, which governs how many trending hashtags are written to the dataset per run. Because the public endpoint caps unauthenticated requests at 3 items, test your pipelines using the default cap before scaling collection across multiple regions.

    None of its 3 controls is strictly required, so the defaults below produce a valid run on their own. Nothing in the payload below is illustrative. Those are the schema's prefilled defaults for TikTok Hashtag Trends Scraper, so the request works once your token is in place.

    Call the synchronous endpoint to start a run and receive dataset items in one request:

    curl -X POST "https://api.apify.com/v2/acts/crawlerbros~tiktok-hashtag-trends-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","period":"7","maxRanks":3}'

    The same run from Python, using the official client:

    from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")

run_input = {
  "country": "US",
  "period": "7",
  "maxRanks": 3
}

run = client.actor("crawlerbros~tiktok-hashtag-trends-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

    And from Node.js:

    import { ApifyClient } from 'apify-client'

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' })

const input = {
  "country": "US",
  "period": "7",
  "maxRanks": 3
}

const run = await client.actor('crawlerbros~tiktok-hashtag-trends-scraper').call(input)
const { items } = await client.dataset(run.defaultDatasetId).listItems()
console.log(items)

    Because the call is synchronous, your client waits for the whole run. Keep it for exploration. For scheduled work, start the run without waiting and collect the dataset afterwards, so network trouble costs you a retry rather than the results.

    Which TikTok Hashtag Trends Scraper inputs matter, and which can you skip?

    The input schema exposes 3 controls, of which 0 are required. Use the country control to target specific geographic markets, and adjust the period control between 7, 30, and 180 days depending on your analytical horizon.

    • country (string): ISO 2-letter country code for the target market (e.g. US, GB, JP, KR, BR). Country-specific results depend on a residential proxy IP in that country being available - otherwise the server defaults to the IP's detected region. Default: "US".
    • period (string): Trend observation window. 7 days shows recent viral spikes; 30 days shows sustained trends. Default: "7".
    • maxRanks (integer): Maximum number of trending hashtags to return. TikTok's public endpoint caps unauthenticated requests at 3 items. Default: 3.

    Fixed-choice controls: period accepts 7 (7 days (recent spikes)), 30 (30 days (sustained trends)), 180 (180 days (long-term)).

    Returned records provide essential trend metrics such as video views, post counts, and popularity curves for competitive benchmarking and content planning. However, the output conspicuously omits individual user profiles, direct video files, and historical analytics beyond the selected time window.

    • hashtagId - TikTok's internal hashtag identifier
    • hashtagName - hashtag text without the # symbol
    • publishCnt - number of videos published using this hashtag in the observed period
    • rankIndex - rank position in the trending list (1 = most trending)
    • popularityCurve - array of { time, value } data points showing trend momentum over the period
    • vv - total video views on content using this hashtag
    • observedCountry - country code used for this query
    • observedPeriod - time period in days used for this query
    • scrapedAt - ISO 8601 timestamp of collection

    These are the documented fields. Optional ones can be empty on a given record, so measure how often each field your deliverable depends on is populated across a real sample before automating the handoff.

    How do you build the workflow end to end?

    Open TikTok Hashtag Trends Scraper and work through these in order. Each step ends with something to check, so a bad configuration surfaces on a small run rather than a scheduled one.

    1. Set the country input to your target two-letter ISO market code such as US or GB before launching your first run.
    2. Choose a period value of 7, 30, or 180 to define your observation window for trend momentum.
    3. Keep maxRanks at its default cap of 3 to verify record structure without exhausting your budget.
    4. Execute the run and verify that the output dataset contains hashtagId, hashtagName, and rankIndex fields.
    5. Check that the popularityCurve array contains time and value objects for each returned hashtag.
    6. Inspect the observedCountry and observedPeriod fields on every row to confirm dataset provenance.
    7. Check that each country run returns that market: country-specific results depend on a matching proxy IP being available, and the Actor has no proxy setting of its own to change.

    How do you apply it? Three worked playbooks

    These are TikTok Hashtag Trends Scraper's own documented use cases, each worked through as an operating pattern rather than a description.

    Use case 1: Content strategy

    Outcome: Identify the hashtags driving the most views right now in your target market and incorporate them into upcoming posts

    Configure: Set country to US, period to 7, and maxRanks to 3.

    Working method: Run the Actor for your target market using a 7-day observation window, then sort the resulting dataset by view count to isolate top-performing tags.

    Deliverable: A structured dataset containing the top 3 trending hashtags, their view counts, and recent post volumes for your content calendar.

    Stop condition: The run exits with zero items because TikTok restricted access from the current IP address.

    Use case 2: Campaign timing

    Outcome: Monitor the popularity curve to catch hashtags at the start of their upward trend before they peak

    Configure: Set country to GB, period to 30, and maxRanks to 3.

    Working method: Collect 30-day trend data and inspect the time-series values inside the popularityCurve array to identify tags whose momentum slope is rising rather than flattening.

    Deliverable: A chronological trend progression chart built from popularity curve data points for planning campaign launches.

    Stop condition: The popularityCurve array returns flat or declining values across the entire observation window.

    Use case 3: Market research

    Outcome: Compare trending hashtags across countries to understand regional audience interests and cultural moments

    Configure: Set country to JP, period to 180, and maxRanks to 3.

    Working method: Execute separate runs across different regional country codes using the 180-day window, then compare the resulting hashtag names and view distributions side by side.

    Deliverable: A comparative cross-regional dataset highlighting distinct cultural trends and regional audience engagement metrics.

    Stop condition: Mismatch between requested country codes and the observedCountry field in the returned dataset rows.

    What breaks, and how do you design around it?

    TikTok's public endpoint enforces a strict unauthenticated limit of 3 hashtags per request, so scale your monitoring by scheduling multiple country-specific runs. When TikTok restricts Creative Center access from the current IP, the run logs a clear message and exits cleanly without error rows, so alert on runs that finish with no records and retry them later.

    Do not use this Actor if you need to scrape individual videos or user profiles at scale, as it only returns aggregate hashtag trends from the Creative Center. For direct post extraction and video metrics, use the TikTok Post Scraper. If your objective involves capturing live chat streams or real-time viewer events, this aggregate trend tool will not meet your requirements; use the TikTok LIVE Event Stream Scraper instead. Similarly, when your workflow requires downloading source video files and cover images rather than analyzing trend metrics, deploy the TikTok Downloader API to retrieve direct storage links. It is also the wrong tool for trend history beyond 180 days, the longest period it offers.

    What should you check before trusting the output?

    • Verify that hashtagId and hashtagName are populated strings and never null or empty.
    • Check that rankIndex starts at 1 and increments sequentially without gaps.
    • Confirm that publishCnt and vv contain valid numeric view and post counts.
    • Ensure the popularityCurve array contains time-series objects rather than empty arrays.
    • Stop scheduled runs immediately if the dataset returns zero items alongside a clean exit log indicating IP restriction.

    None of this proves a record is correct. It gives a scheduled TikTok Hashtag Trends Scraper run defined points where it should stop instead of quietly passing bad data downstream.

    Frequently asked questions

    Why does the actor only return 3 hashtags per request?

    TikTok's public Creative Center endpoint caps unauthenticated requests at 3 hashtags per query. This is a platform-level limit enforced by TikTok rather than a restriction of the Actor itself, ensuring stable data delivery within public access constraints.

    What is the total cost per run on the free tier?

    Result charges are $0.005 per result, which equals $5.00 per 1,000 results on the free tier. Apify also bills platform usage consumed during the run on top of these result charges.

    How do I monitor multiple countries effectively?

    Run the Actor once for each target ISO country code. Because each run executes quickly and returns up to 3 results, monitoring 10 to 20 countries daily remains efficient and cost-effective.

    What does the popularityCurve field represent?

    The popularityCurve field provides an array of time and value data points showing how a hashtag's popularity score evolved over your selected observation window, helping you determine if a trend is rising or declining.

    What happens if TikTok restricts access from my IP address?

    When TikTok restricts Creative Center API access from certain IP ranges, the Actor logs a clear message and exits cleanly without pushing error rows to your dataset, preventing pipeline crashes.

    Where to go next

    When you are ready to run it, open TikTok Hashtag Trends Scraper on Apify; the free plan covers up to 1,000 results a month.

    Start with the TikTok Hashtag Trends Scraper Actor page for the current input schema, pricing tier, and run history.

    It is part of the TikTok Scraping Suite, which puts every related Actor on one page with its price and run history.

    If you are comparing approaches rather than committing to one Actor, these category pages list every option we publish:

    Other Actors we maintain for related data:

    Related guides:

    Resources

    • Actor documentation, input schema, and pricing: verified against the published Actor on 2026-09-24.

    • Actor last updated by its maintainers on 2026-06-30.

    • Run outcome figures cover the 30 day public window ending 2026-09-24.

    • TikTok Hashtag Trends Scraper on Apify

    Featured actors

    TikTok Hashtag Trends Scraper

    Track trending TikTok hashtags from the Creative Center. Returns rank, post count, video views, popularity curve, and top creators for each trending hashtag.

    Run on Apify ↗