# TikTok Trends Scraper: Trending Hashtags and Top Videos (`themineworks/tiktok-trends-scraper`) Actor

Scrape TikTok Creative Center trends by country: trending hashtags for 7, 30 or 90 days with rank, industry charts, posts, views, daily popularity curve and top creators, plus top videos with views, organic views and engagement rate. No login.

- **URL**: https://apify.com/themineworks/tiktok-trends-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Social media, Marketing, Automation
- **Features:** Limited permissions
- **Stats:** 4 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.45 / 1,000 trends

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TikTok Trends Scraper: Trending Hashtags and Top Videos

[![110 TikTok trending hashtags and top videos for the US in 19 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/tiktok-trends-scraper-hero.png)](https://console.apify.com/actors/ZsOMt3Am1eo4vuRYf/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

From **The Mine Works**, makers of [TikTok Scraper: Hashtag, Search & Trending Videos](https://apify.com/themineworks/tiktok-hashtag-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) and [TikTok Transcript Scraper](https://apify.com/themineworks/tiktok-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), with over 290,000 runs across 310+ public actors.

Updated 31 Oct 2026: first release. Trending hashtags from TikTok's Creative Center for 27 countries and 7, 30 or 90 days, with every industry chart merged into one list, the daily popularity curve and the top creators of each hashtag, plus the top videos for the US, Japan, Vietnam, Thailand and Indonesia with views, organic views, engagement rate and 6 second view rate. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Every chart of a country in one list.** TikTok shows visitors who are not logged in the top 3 hashtags of each chart. This actor reads the overall chart and all 15 industry charts (Games, Beauty & Personal Care, Food & Beverage and so on) and merges them, so one country and window gives about 40 to 48 hashtags instead of 3. `ranked_in` lists every chart a hashtag ranks in and its rank there.
- **Numbers in columns, ready to sort.** `posts`, `views` and `views_per_post` as whole numbers, the daily popularity curve as date and value pairs, `curve_peak_date`, `trend_direction`, and `data_through`, the last day of data TikTok shows, so you always know how fresh a chart is.
- **Top videos with the numbers advertisers use.** Views in the window and since posting, organic views, engagement rate, 6 second view rate, the author's followers and bio. Read by views, by engagement and by 6 second view rate, across the five content filters, merged into one row per video.
- **Pay per row, nothing for errors.** Countries a chart does not cover, the summary and info rows and duplicates are never charged. No TikTok account, cookies or API key.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/ZsOMt3Am1eo4vuRYf/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Social media and video family:** [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the trending hashtags and top videos for the United States over the last 7 days, 110 rows. It took 19 seconds in our test run:

```json
{
  "trendTypes": ["hashtags", "videos"],
  "countries": ["US"]
}
```

Add more countries to the list to read them in the same run; each country is read on its own and labelled in `country_code`.

Apify's free plan includes $5 of credit every month, which covers about 3,600 rows at this actor's price.

#### Copy to your AI assistant

```text
themineworks/tiktok-trends-scraper on Apify. Reads TikTok Creative Center trends with no login: trending hashtags (27 countries, 7, 30 or 90 days, overall chart plus 15 industry charts merged) and top videos (US, JP, VN, TH, ID; 7 or 30 days). Call ApifyClient("TOKEN").actor("themineworks/tiktok-trends-scraper").call(run_input={"trendTypes": ["hashtags", "videos"], "countries": ["US", "GB"], "period": "7"}), then client.dataset(run["defaultDatasetId"]).list_items().items. Input: trendTypes (list: hashtags, videos), countries (list of 2 letter codes), period ("7", "30" or "90"; videos use 30 for 90), industries (list of chart keys such as all-industries, games, beauty-personal-care; empty = all 16 charts), includeTopCreators (default true), videoSortBy (list: views, engagement, completion; empty = all), videoContentTags (list: all-content, beauty-care, fashion, food-beverage, lifestyle-leisure, technology-finance; empty = all), organicOnly (default false), maxItems (default 1000). Hashtag rows have record_type "hashtag": hashtag, hashtag_id, hashtag_url, rank, chart, ranked_in (chart, industry_id, rank), posts, views, views_per_post, industries, industry_ids, curve (date, value 0 to 100), curve_last_value, curve_average, curve_peak_date, trend_direction (up, down, flat), top_creators (rank, username, nickname, followers, country_code, user_id, profile_url, avatar_url), country_code, country_name, period_days, data_through. Video rows have record_type "video": video_id, video_url, title, created_at, cover_url, video_file_url, author_username, author_nickname, author_bio, author_followers, author_id, author_profile_url, views, views_lifetime, organic_views, organic_views_lifetime, engagement_rate, engagement_rate_lifetime, view_rate_6s, view_rate_6s_lifetime, rank, chart, ranked_in (chart, sort_by, content_tag, rank), content_tags, organic_only, country_code, period_days, data_through. Each run also writes one row with _type "summary" (with freshness_note when the hashtag charts are more than 7 days old), an _type "info" row when rows were delivered, and an _type "error" row per country or value that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~tiktok-trends-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme. Token: https://console.apify.com/account/integrations?fpr=ymnoit&utm_source=apify-readme&utm_medium=referral
```

### Key features

- **27 countries for hashtags.** United States, United Kingdom, Canada, Australia, Germany, France, Italy, Spain, Argentina, Brazil, Colombia, Mexico, Egypt, Israel, Saudi Arabia, United Arab Emirates, Turkey, South Africa, Indonesia, Japan, South Korea, Malaysia, Philippines, Singapore, Taiwan, Thailand and Vietnam. In our test of all 27 for 7 days, every country returned between 33 and 48 hashtags, 1,171 in all.
- **Industry charts.** Pick the industries you care about, or leave the list empty to read the overall chart and all 15 industries. The headline `rank` comes from the overall chart when the hashtag is in it, otherwise from the industry chart named in `chart`.
- **Popularity curve.** One point a day on TikTok's 0 to 100 scale, where the busiest day of the window is 100. It shows the shape of a trend, not its volume; use `posts` and `views` for volume.
- **Top creators of each hashtag.** Username, nickname, followers, country and profile link of the creators TikTok lists for the hashtag, for influencer lists.
- **Top videos.** For the US, Japan, Vietnam, Thailand and Indonesia: each sort (views, engagement rate, 6 second view rate) times each content filter (all content, Beauty & Care, Fashion, Food & Beverage, Lifestyle & Leisure, Technology & Finance), merged into one row per video. About 66 to 70 videos per country with every chart read.
- **Built for pipelines.** One country and one chart is one request: from Clay, n8n or an AI agent, set `maxItems` and the actor stops reading charts once it has enough rows. A blocked run stops after its first request, so a schedule that runs every few minutes never pays for a run that cannot get data.

### How to use it

#### Basic: what is trending in one country this week

```json
{
  "trendTypes": ["hashtags"],
  "countries": ["GB"],
  "period": "7"
}
```

About 44 hashtags, each with its rank, posts, views, curve and top creators. Sort by `views_per_post` to find hashtags that pull views without many posts yet.

#### Weekly report across markets

```json
{
  "trendTypes": ["hashtags", "videos"],
  "countries": ["US", "JP", "ID", "TH", "VN"],
  "period": "7"
}
```

Five countries with hashtags and top videos, about 560 rows. Save it as a task and schedule it every Monday; compare runs on `hashtag_id` to see what entered and left the charts.

#### One industry only

```json
{
  "trendTypes": ["hashtags"],
  "countries": ["US", "BR", "MX"],
  "period": "30",
  "industries": ["beauty-personal-care", "apparel-accessories"]
}
```

The top hashtags of two industry charts in three countries over 30 days.

#### Organic top videos

```json
{
  "trendTypes": ["videos"],
  "countries": ["US"],
  "period": "30",
  "organicOnly": true
}
```

The videos that ranked on their unpaid results, with organic views next to total views.

#### One call per record from Clay, n8n or an agent

```json
{
  "trendTypes": ["hashtags"],
  "countries": ["DE"],
  "industries": ["all-industries"],
  "maxItems": 3
}
```

The overall top 3 for one country: one request, a few seconds.

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `trendTypes` | array | `["hashtags"]` | `hashtags`, `videos` or both. |
| `countries` | array | `["US"]` | Two letter codes. Hashtags: 27 countries. Top videos: US, JP, VN, TH, ID. |
| `period` | string | `"7"` | `"7"`, `"30"` or `"90"` days. Top videos cover 7 or 30 days; 90 reads videos for 30. |
| `industries` | array | empty | Hashtag charts to read: `all-industries` (the overall chart) and 15 industry keys. Empty reads all 16 and merges them. |
| `includeTopCreators` | boolean | `true` | Adds the top creators of each hashtag. |
| `videoSortBy` | array | empty | `views`, `engagement`, `completion` (6 second view rate). Empty reads all three. |
| `videoContentTags` | array | empty | `all-content`, `beauty-care`, `fashion`, `food-beverage`, `lifestyle-leisure`, `technology-finance`. Empty reads all six. |
| `organicOnly` | boolean | `false` | Rank top videos by organic results only. |
| `maxItems` | integer | `1000` | Most rows per run, 1 to 20,000. |

### What data do you get?

Two kinds of rows, told apart by `record_type`. Data rows have no `_type` field; the summary, info and error rows do, so a filter on `_type` separates them.

**Hashtag rows** (`record_type: "hashtag"`)

| Field | What it is |
|---|---|
| `hashtag`, `hashtag_id`, `hashtag_url` | Name without the #, TikTok's id, and the link to the hashtag page |
| `rank`, `chart` | Rank and the chart it comes from (`All industries` or an industry name) |
| `ranked_in` | Every chart the hashtag ranks in this run: `chart`, `industry_id`, `rank` |
| `posts`, `views`, `views_per_post` | Posts and video views in the window, and views divided by posts |
| `industries`, `industry_ids` | Industries TikTok tags the hashtag with |
| `curve` | One point a day: `date` and `value` (0 to 100) |
| `curve_last_value`, `curve_average`, `curve_peak_date` | Last day's value, the average, and the busiest day |
| `trend_direction` | `up`, `down` or `flat`: the last day against 3 days earlier, a change of 10 points or more counts |
| `top_creators` | `rank`, `username`, `nickname`, `followers`, `country_code`, `user_id`, `profile_url`, `avatar_url` |
| `country_code`, `country_name`, `period_days`, `data_through` | The chart's country, window and last day of data |

**Video rows** (`record_type: "video"`)

| Field | What it is |
|---|---|
| `video_id`, `video_url`, `title`, `created_at` | The video, its link, caption and posting time |
| `cover_url`, `video_file_url` | Cover image and video file (signed links that expire within hours) |
| `author_username`, `author_nickname`, `author_bio`, `author_followers`, `author_id`, `author_profile_url` | The creator |
| `views`, `views_lifetime` | Views in the window and since posting |
| `organic_views`, `organic_views_lifetime` | Unpaid views in the window and since posting |
| `engagement_rate`, `engagement_rate_lifetime` | Engagement rate, 0 to 1 |
| `view_rate_6s`, `view_rate_6s_lifetime` | Share of views that lasted 6 seconds, 0 to 1 |
| `rank`, `chart`, `ranked_in`, `content_tags` | Rank and chart, every chart it ranks in (`sort_by`, `content_tag`, `rank`), and its content filters |
| `organic_only`, `country_code`, `country_name`, `period_days`, `data_through` | How and where the charts were read |

Both kinds also carry `source` (`TikTok Creative Center`), `position` (order within its country and type) and `scraped_at`.

**Summary row** (`_type: "summary"`, never charged): `jobs_planned`, `jobs_done`, `charts_read`, `charts_empty`, `charts_failed`, `hashtags_delivered`, `videos_delivered`, `duplicates_merged`, `hashtag_data_through`, `video_data_through`, `hashtag_data_age_days`, `freshness_note`, `http_requests`, `http_kilobytes`, `stopped_by_max_cost`, `stopped_by_block_guard`, `shortfall_reason` when fewer rows came back than asked, and `per_job`, one entry per country and type. The same summary is saved as the `OUTPUT` record of the run.

**Error rows** (`_type: "error"`, never charged): one per country that a chart does not cover (`unsupported_country`), per unknown input value (`invalid_input`), or per country TikTok did not answer for (`blocked`), with `identifier` and `reason`.

#### Stable fields for automations

These were present in every row of their kind in our test runs (1,171 hashtag rows from 27 countries and 343 video rows from 5), and their names will not change:

| Field | What it is |
|---|---|
| `record_type` | `hashtag` or `video` |
| `hashtag_id` / `video_id` | The key to store and join on |
| `hashtag` / `title` | Name or caption |
| `rank`, `chart`, `ranked_in` | Where it ranks |
| `posts`, `views` | Volume (hashtags); `views` and `organic_views` (videos) |
| `curve`, `trend_direction`, `data_through` | Shape and freshness (hashtags) |
| `country_code`, `period_days` | Which chart |
| `author_username`, `author_followers` | The creator (videos) |

Optional, present only when TikTok shows a value: `industries` (1,152 of 1,171 hashtag rows), `top_creators` (1,170 of 1,171), `content_tags` (290 of 343 videos ranked under a content filter; the rest ranked only in the all content charts), `author_bio`.

#### Output examples

A hashtag that ranks in the overall US chart and tops the Games chart (test run, 31 Oct 2026, trimmed):

```json
{
  "record_type": "hashtag",
  "hashtag": "marvelrivalsavengers",
  "hashtag_id": "7462773581512966150",
  "hashtag_url": "https://www.tiktok.com/tag/marvelrivalsavengers",
  "rank": 2,
  "chart": "All industries",
  "ranked_in": [
    { "chart": "All industries", "rank": 2 },
    { "chart": "Games", "industry_id": "25000000000", "rank": 1 }
  ],
  "posts": 110088,
  "views": 24120743,
  "views_per_post": 219,
  "industries": ["Games"],
  "curve": [
    { "date": "2026-10-09", "value": 95.54 },
    { "date": "2026-10-10", "value": 100 },
    { "date": "2026-10-15", "value": 25.89 }
  ],
  "curve_peak_date": "2026-10-10",
  "trend_direction": "up",
  "top_creators": [
    { "rank": 1, "username": "cinnavry", "followers": 7219, "country_code": "US", "profile_url": "https://www.tiktok.com/@cinnavry" }
  ],
  "country_code": "US",
  "period_days": 7,
  "data_through": "2026-10-15"
}
```

A top video in the US over 7 days, third by views overall and first in Fashion (same run, trimmed):

```json
{
  "record_type": "video",
  "video_id": "7686545222628658446",
  "video_url": "https://www.tiktok.com/@pierrahh/video/7686545222628658446",
  "title": "#walmartpartner runway silhouettes sourced at a cute price point. shop for your fall wardrobe @Walmart",
  "created_at": "2026-09-17T16:41:23.000Z",
  "author_username": "pierrahh",
  "author_followers": 75376,
  "views": 24601701,
  "views_lifetime": 66220075,
  "organic_views": 446268,
  "engagement_rate": 0.000538,
  "view_rate_6s": 0.01172,
  "rank": 3,
  "chart": "Video views, All content",
  "ranked_in": [
    { "chart": "Video views, All content", "sort_by": "views", "rank": 3 },
    { "chart": "Video views, Fashion", "sort_by": "views", "content_tag": "Fashion", "rank": 1 }
  ],
  "content_tags": ["Fashion"],
  "country_code": "US",
  "data_through": "2026-10-29"
}
```

An error row for a country with no top video chart (nothing charged):

```json
{ "_type": "error", "error_type": "unsupported_country", "identifier": "GB videos", "reason": "The Creative Center has top video charts only for US, JP, VN, TH, ID, not \"GB\"." }
```

### Pricing

Pay per event: you pay for the rows you receive, plus a flat $0.003 per run, whatever memory you choose. Hashtag and video rows cost the same.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `trend-scraped` | Once per hashtag or video row stored in your dataset | $1.35 per 1,000 | $0.90 per 1,000 | $0.68 per 1,000 | $0.45 per 1,000 |
| `run-start` | Once per run, after the first chart returned rows | $0.003 | $0.003 | $0.003 | $0.003 |

The price of one row is the price per 1,000 divided by 1,000.

Never charged:

- countries a chart does not cover and unknown input values (each gets an error row);
- a hashtag or video found in several charts: it is one row;
- rows past your `maxItems`;
- the summary, info and error rows;
- a run that delivers no row: the start fee is charged only once a chart has returned rows;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Compare runs on `hashtag_id` or `video_id` and `rank` to see what entered, climbed and dropped out. Check `data_through` first: if it has not moved since the last run, TikTok has not refreshed that chart yet.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

TikTok's Creative Center trends pages (ads.tiktok.com), the public charts TikTok publishes for marketers, as anyone sees them without logging in. It does not log in and does not open tiktok.com profiles or videos.

#### Why only about 44 hashtags per country, and 3 per chart?

TikTok shows visitors who are not logged in the top 3 hashtags of each chart and the top 4 videos of each video chart, whatever page size is asked for. Any tool that does not log in sees the same limit. Reading all 16 hashtag charts and all 18 video charts of a country is how this actor gets the most out of it.

#### Where are trending songs, creators and rank changes?

TikTok removed them from the public Creative Center in its 2026 redesign: the old trend pages now redirect to the new site, the creator tab is switched off in TikTok's own page code, there is no song tab, and the hashtag charts no longer carry a rank change. The creators behind each trending hashtag are still there, in `top_creators`. For the videos that use a given song, use our TikTok Sounds Scraper with the song's link.

#### Why is data_through older than today?

`data_through` is the last day in TikTok's own chart. On 31 Oct 2026 the hashtag charts ended on 15 Oct 2026 for every country and window, while the top video charts ended on 29 Oct 2026. The actor reports what TikTok shows and does not guess newer numbers; the summary row has a `freshness_note` whenever the hashtag charts are more than 7 days old.

#### What do the curve values mean?

Each hashtag's busiest day in the window is 100 and the other days are scaled to it. Two hashtags with the same curve can have very different volumes, so read the curve for timing and `posts` and `views` for size.

#### How long does a run take?

In our tests: 19 seconds for the "Try it" input (US, 110 rows), 47 seconds for three countries with hashtags and videos (266 rows), and under 7 minutes for all 27 countries with videos for the five video countries (1,514 rows). A single chart answers in about a second.

#### Do I need an account, cookies or a proxy?

No. The actor reads public charts over Apify Proxy, which is included. Nothing to set up.

#### Which actor should I use for other TikTok data?

[TikTok Scraper: Hashtag, Search & Trending Videos](https://apify.com/themineworks/tiktok-hashtag-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for the videos under a hashtag or a keyword, and [TikTok Transcript Scraper](https://apify.com/themineworks/tiktok-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) for what is said in a video.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. The dataset has three ready views: Hashtags, Top videos and Hashtag creators. In CSV and Excel, `curve`, `ranked_in` and `top_creators` are flattened into columns such as `curve/0/value`.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/tiktok-trends-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http tiktok-trends-scraper "https://mcp.apify.com/?tools=themineworks/tiktok-trends-scraper"`

#### Is it legal to scrape TikTok trends?

The actor reads only charts that TikTok publishes for anyone to see without logging in. Creator rows hold public profile names and follower counts. You are responsible for how you use the data, including TikTok's terms and data protection law such as GDPR and CCPA. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's rows to a sheet with Apify's Google Sheets integration; one row per hashtag or video fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "the top hashtags in our five markets every Monday to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

### More from The Mine Works

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Followers & Following](https://apify.com/themineworks/instagram-followers-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Search Scraper](https://apify.com/themineworks/reddit-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Twitter / X Scraper](https://apify.com/themineworks/twitter-x-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [YouTube Transcript](https://apify.com/themineworks/youtube-transcript-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Xiaohongshu (RED) Scraper](https://apify.com/themineworks/xiaohongshu-explore-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Scraper](https://apify.com/themineworks/telegram-channel-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Telegram Channel Finder](https://apify.com/themineworks/telegram-channel-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Pinterest Profile Scraper](https://apify.com/themineworks/pinterest-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a country that returns fewer rows than the Creative Center shows, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Read TikTok's Creative Center trends by country and get every trending hashtag and top video back as one row, with rank, posts, views, popularity curve, top creators and engagement, no login.*

# Actor input Schema

## `trendTypes` (type: `array`):

Trending hashtags (27 countries, 7, 30 or 90 days, by industry) and top videos (US, Japan, Vietnam, Thailand and Indonesia, 7 or 30 days). Pick one or both.

## `countries` (type: `array`):

Each country is read on its own. Hashtags: all 27 listed. Top videos: US, JP, VN, TH and ID only (other countries get an error row and cost nothing).

## `period` (type: `string`):

Last 7, 30 or 90 days. Top video charts cover 7 or 30 days, so 90 reads videos for 30 days.

## `industries` (type: `array`):

Leave empty to read the overall chart and all 15 industry charts and merge them (about 40 to 48 hashtags per country). Pick some to read only those. TikTok shows the top 3 of each chart to visitors who are not logged in.

## `includeTopCreators` (type: `boolean`):

Adds the creators TikTok lists for each hashtag: username, nickname, followers, country and profile link. Same price either way.

## `videoSortBy` (type: `array`):

Leave empty to read all three rankings and merge them. Each chart shows its top 4 videos to visitors who are not logged in.

## `videoContentTags` (type: `array`):

Leave empty to read all content plus the five content filters and merge them.

## `organicOnly` (type: `boolean`):

On: rank videos by their organic (unpaid) results only. Off: all views, paid included, as the Creative Center shows by default.

## `maxItems` (type: `integer`):

The most hashtag and video rows this run returns, 1 to 20,000. A country gives about 44 hashtags and about 66 videos with every chart read.

## Actor input object example

```json
{
  "trendTypes": [
    "hashtags",
    "videos"
  ],
  "countries": [
    "US"
  ],
  "period": "7",
  "industries": [],
  "includeTopCreators": true,
  "videoSortBy": [],
  "videoContentTags": [],
  "organicOnly": false,
  "maxItems": 1000
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "trendTypes": [
        "hashtags",
        "videos"
    ],
    "countries": [
        "US"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/tiktok-trends-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "trendTypes": [
        "hashtags",
        "videos",
    ],
    "countries": ["US"],
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/tiktok-trends-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "trendTypes": [
    "hashtags",
    "videos"
  ],
  "countries": [
    "US"
  ]
}' |
apify call themineworks/tiktok-trends-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/tiktok-trends-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ZsOMt3Am1eo4vuRYf/builds/OlsDnByQxGdmlARLi/openapi.json
