DEV Community

Cover image for TikTok trending hashtags report with n8n (free workflow)
Scraper Finder
Scraper Finder

Posted on

TikTok trending hashtags report with n8n (free workflow)

Last updated: 18 November 2026

This workflow returns TikTok trending hashtags with ranks, post counts, video views, momentum curves and creator context. Import it into n8n, add your Apify token as a Query Auth credential, and edit Configure input. A first run capped at 25 rows costs about $0.42 in Actor charges on Apify's Free plan, plus platform compute.

Disclosure: I maintain the free MIT workflow and skill collections on scraperfinder.com, and scraping runs a public Apify Actor on your own Apify account as paid usage. This article was drafted with AI help, with every field, setting and price checked against the workflow files and the Actor's pricing.

Friday's content planning is approaching, and your hashtag shortlist still comes from old screenshots. A fresh chart gives you ranks and momentum to inspect before choosing hashtags for your next post.

What does the hashtag report return?

The workflow reads TikTok Creative Center's trending-hashtag charts for your selected markets and lookback windows. The main fields are:

Field What you get
rankIndex Rank
hashtagName Hashtag
publishCnt Post count
vv Video views

The Actor also returns a day-by-day momentum curve and top creators behind each trend. Use the curve to inspect how popularity changes across the window, alongside the headline counts.

Context fields include observedCountry, observedPeriod and scrapedAt. Keep them with the hashtag when you pass rows downstream, so the report identifies which market and window you requested.

The workflow ends at Rows ready. Its optional destination is Google Sheets (optional), which ships disabled.

How do you import and run it in n8n?

  1. Import the workflow. In the n8n editor, open the ⋯ menu, choose Import from URL, and paste the workflow import link. You can also download that JSON and use Import from file.

  2. Create the credential. Copy your Apify API token from Apify integrations. Create a Query Auth credential in n8n with parameter name token and your API token as its value. Select that credential in Run Apify Actor.

  3. Edit Configure input. Use this starter input:

{
  "mode": "trendingHashtags",
  "countries": [
    "US"
  ],
  "periods": [
    "7"
  ],
  "maxItems": 25
}
Enter fullscreen mode Exit fullscreen mode
  1. Execute the workflow and inspect Rows ready. Check the hashtag names, ranks and market context before connecting a destination. Normalize + dedupe trims strings, drops empty values, adds _source and _scrapedAt, and keeps one row per hashtagName.

  2. Connect the report and schedule it. To append rows to a sheet, add your credential and sheet to Google Sheets (optional), use automatic column mapping, and enable the node. Review Daily trigger before enabling scheduled runs.

The starter requests the US chart with a 7-day lookback and caps data rows at 25. Treat that cap as a ceiling, since the available chart results determine what comes back.

Which input settings change your coverage?

Start with countries and periods. Each market adds its own ranked rows. A periods value of "7" shows recent spikes, while "90" gives a longer-term view.

The starter leaves these defaults in effect:

  • includeOverallRanking: true, including each market's overall top-3 hashtag chart.
  • scanAllIndustries: true, reading all 19 industry charts for each market and window.
  • includeCreatorLeaders: false, leaving the additional creator leaderboard off.

Scanning industries widens coverage from 3 to up to 60 hashtags per market and window, before the data-row cap. To focus on selected industries, set scanAllIndustries to false and populate industries. That field is ignored while scanning all industries.

For a creator shortlist, enable includeCreatorLeaders. It adds creator rows ranked by how many collected trends credit them. minHashtagAppearances defaults to 2 and accepts values from 1 through 10.

Why does it dedupe on hashtagName?

The same hashtag can appear across the collected charts. Normalize + dedupe keeps one row for each hashtagName, giving you a shortlist without repeated hashtag names.

That key matters when you add markets or windows. A matching hashtag name can collapse into one row even when its observations came from different countries or periods. The key does not include observedCountry or observedPeriod.

For a report that must preserve each market and window separately, change the deduplication logic to include those fields before combining the results. Otherwise, keep the starter's market and window while you establish the report.

Deduplication happens after collection. Budget against the Actor's billable dataset results, rather than the final number of normalized rows.

What does the first run cost?

On Apify's Free plan, the Actor charges a start event per GB of run memory, plus $0.00099 per result. Its default memory is 4096 MB, or 4 GB. The workflow leaves that default in place.

Charge Calculation Total
Actor start 4 GB × $0.10 $0.40
Results 25 × $0.00099 About $0.02
Actor charges combined Start plus results, rounded after addition About $0.42

Apify platform usage, including compute, is billed on top. No fixed compute price is included here, so about $0.42 is the Actor-charge estimate for 25 results.

Running that same amount daily for 30 days costs about $12.74 in Actor charges, plus compute. The Free plan's $5.00 credit covers 11 such sets of Actor charges before accounting for compute. Paid plans have lower event prices.

If you enable creator rows or expand collection, account for the results written to the Actor's dataset when estimating charges.

What should you check when something breaks?

If Apify returns an error object, the workflow stops with Apify's message instead of writing it as a junk row. Read that message before changing input or retrying.

The synchronous wait is 300 seconds, and the node timeout is 300000 milliseconds. If the request times out, check the run's status in your Apify account before starting another run. A fresh Actor start incurs another start charge.

If repeated hashtags disappear, inspect the hashtagName deduplication described above. If no rows reach your sheet, check whether Google Sheets (optional) is enabled and has its credential and destination configured.

This TikTok comparison page compares the other tools and the official API for TikTok by fields and price.

FAQ

Does this work on n8n Cloud and self-hosted n8n?

Yes. It uses core nodes: Schedule Trigger, Code, HTTP Request, No Operation and Google Sheets.

Does the imported file contain credentials or a sheet ID?

No. The JSON contains no token, credential or sheet ID. Add your own during setup.

Can this workflow return trending videos?

The Actor supports mode: "trendingVideos". Use videoCountries, videoPeriods and videoSortBy for that mode. Its output fields include caption, views, engagementRate, author.username and createdAt.

How far can I raise maxItems?

It accepts 1 through 5000 and defaults to 1000. Creator rows are excluded from this data-row limit, so it is not a cap on every billable result.

Top comments (0)