TikTok Trending Hashtags Scraper

Get current TikTok trending hashtags from TikTok One Trends. Each result includes the hashtag's rank, total posts, views, popularity curve, country, and selected industry.

No TikTok account, cookies, or API key are required.

Use when / avoid when

Use this Actor when you need a fast, current public snapshot of TikTok hashtag trends for a country or industry, then want to export those results into content planning, a report, or a downstream video search. Avoid this Actor when your workflow requires a complete Top 100, historical rank deltas, promoted-status data, or authenticated TikTok analytics; TikTok does not make those fields available in its current public Trends response.

Focused standalone workflow

This Actor is designed as a focused standalone workflow: start with a country and industry, collect the available trends, then feed the validated dataset into your content calendar, research sheet, or a separate TikTok video-analysis workflow. Schedule the same input weekly to compare the source records your own process has stored over time.

What you get

Every dataset item is validated before it is written and billed.

Field	Description
rank	Current rank in the selected TikTok Trends list.
hashtag_name	Hashtag text without #.
hashtag_id	TikTok's identifier for the hashtag.
post_count	Number of posts reported by TikTok.
video_views	Views reported by TikTok.
sparkline_data	TikTok's popularity curve, with dates and values.
country_code	The country filter used for the run.
industry_name	The industry filter used for the run.
time_period_days	One of 7, 30, or 90.
scraped_at	UTC time at which the record was collected.
source_url	Corresponding TikTok One Trends page.

TikTok's replacement Trends endpoint does not currently supply rank-change, promoted, or “new to Top 100” signals. The legacy fields rank_diff, rank_diff_type, is_new_to_top100, and is_promoted are therefore null; this Actor never guesses them.

Input

Input	Default	Description
timePeriod	"7"	Trend window: "7", "30", or "90" days.
country	"US"	Country where you want to research trends.
industry	"All Industries"	Optional industry or niche filter.
maxResults	100	Maximum number of results to write, from 1 to 100.

TikTok controls how many unauthenticated public Trends records are available for each country and industry. If it exposes fewer records than you request, the Actor succeeds with a PARTIAL outcome and charges only for the records it wrote.

Example input

{
  "timePeriod": "7",
  "country": "US",
  "industry": "Beauty & Personal Care",
  "maxResults": 20
}

Sample output

{
  "rank": 1,
  "rank_diff": null,
  "rank_diff_type": null,
  "hashtag_name": "exampletrend",
  "hashtag_id": "123456789",
  "post_count": 51785,
  "video_views": 47526788,
  "is_new_to_top100": null,
  "is_promoted": null,
  "country_code": "US",
  "industry_name": "All Industries",
  "time_period_days": 7,
  "sparkline_data": [
    { "time": "2026-07-13", "value": 100 },
    { "time": "2026-07-14", "value": 62.6 }
  ],
  "scraped_at": "2026-07-21T12:00:00.000Z",
  "source_url": "https://ads.tiktok.com/creative/creativeCenter/trends/hashtag?period=7&region=US"
}

Run outcomes

In addition to the default dataset, every run writes two records to the default key-value store:

Key	Purpose
OUTPUT	Concise final result for integrations.
RUN_SUMMARY	Outcome, counts, charges, source, and completion time.

Possible outcomes are:

• COMPLETE — all requested results were written.
• PARTIAL — TikTok supplied fewer valid records than requested, or an Apify event limit stopped more writes.
• VALID_EMPTY — TikTok successfully confirmed that there were no records for the selected filters.
• INVALID_INPUT — an input value cannot be used (for example, the retired 120-day period).
• UPSTREAM_FAILED — TikTok could not be reached or changed its response contract. The run is marked failed instead of pretending an empty dataset is successful.

Pricing

The Actor uses pay-per-event pricing: $0.003 per validated hashtag written to the dataset. A run that writes 20 results costs $0.06 (20 × $0.003); a run that writes three results costs $0.009. You are not charged for a failed request, an empty source response, or a rejected record.

API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('khadinakbar/tiktok-trending-hashtags-scraper').call({
    timePeriod: '7',
    country: 'US',
    industry: 'All Industries',
    maxResults: 20,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

AI agent / MCP guidance

An AI agent can request a country, industry, and 7/30/90-day window, start this Actor, and read the default dataset plus RUN_SUMMARY before making a recommendation.

Run khadinakbar/tiktok-trending-hashtags-scraper for US beauty trends in the last 7 days, return the dataset records with their source URL and collection time, and state the RUN_SUMMARY.outcome. If the outcome is PARTIAL, VALID_EMPTY, INVALID_INPUT, or UPSTREAM_FAILED, do not describe missing records as zero-demand trends.

The Actor is read-only with respect to TikTok. maxResults is a cap, not a guarantee: pagination stops when TikTok has no more public records. Use the terminal outcome and dataset readback as the source of truth.

Limitations and recovery

TikTok can change public availability, its response shape, the number of records, or country and industry coverage without notice. The Actor retries one transient request failure. If TikTok is unavailable or its response is no longer valid, the Actor returns UPSTREAM_FAILED and marks the run failed instead of producing a misleading successful empty dataset.

If you receive PARTIAL, TikTok supplied fewer matching public records than requested; retry later or broaden the country/industry filter. If you receive VALID_EMPTY, change the country or industry and retry. If you receive INVALID_INPUT, use a supported 7-, 30-, or 90-day window. The retired isNewToTop100 option is intentionally not supported because TikTok no longer supplies that signal.

Verification and freshness

The v1.4 implementation was verified against TikTok One Trends on 2026-07-21 with a live US, 7-day sample. The checked response returned validated hashtag records, rank, post count, views, and a popularity curve; the Actor records its own collection time and source URL on every dataset item. Trend data is live and can change between runs.

Responsible use

Use the data lawfully and in accordance with TikTok's terms and applicable privacy and data-protection laws. Do not use results for spam, harassment, or unauthorized profiling.