# Tiktok Trending Hashtags Analytics (`codebyte/tiktok-trending-hashtags-analytics`) Actor

Unlock TikTok's trending hashtags with comprehensive analytics and audience insights. Gather data on hashtag performance, audience demographics and related trends to supercharge your TikTok content strategy.

- **URL**: https://apify.com/codebyte/tiktok-trending-hashtags-analytics.md
- **Developed by:** [Codebyte](https://apify.com/codebyte) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 441 total users, 10 monthly users, 100.0% runs succeeded, 24 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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 Trending Hashtags Analytics

Discover new trends on TikTok through hashtags.
Get comprehensive analytics and insights for TikTok hashtags. This actor helps you understand hashtag performance, audience demographics, and related trends to optimize your TikTok content strategy.

### Key Features

- Track hashtag popularity and interest over time
- Analyze audience demographics and age distribution
- Discover related interests and regional popularity
- Find trending hashtags, related videos and creators

Perfect for social media managers, content creators, and marketing professionals who want to leverage data-driven insights for their TikTok strategy.

## Input

To start, select the type of result you want to retrieve.

#### Top 100 ranking only

Retrieve the top 100 trending hashtags for a given country and time frame.

```json
{
    "result_type": "top100",
    "country": "US",
    "top100_period": "7"
}
```

#### Example output

```json
[
    {
        "hashtag_id": "73422076",
        "hashtag_name": "lemon8",
        "country_info": {
            "id": "US",
            "value": "United States",
            "label": "US"
        },
        "industry_info": {
            "id": 22000000000,
            "value": "Apparel & Accessories",
            "label": "label_22000000000"
        },
        "is_promoted": false,
        "trend": [
            {
                "time": 1736121600,
                "value": 0.51
            },
            ...
        ],
        "publish_cnt": 33723,
        "video_views": 109725286,
        "rank": 2,
        "rank_diff_type": 4,
        "period": "7",
        "rank_change_readable": "New"
    },
    ...
]

```

#### Top 100 ranking including hashtag analytics

Retrieve the top 100 trending hashtags for a given country and time frame, including hashtag analytics.

```json
{
    "result_type": "top100_with_analytics",
    "country": "US",
    "top100_period": "7"
}
```

#### Example output excerpt

```json
{
    ...
    "analytics": {
            "hashtag_id": "73422076",
            "hashtag_name": "lemon8",
            "video_url": "https://www.tiktok.com/tag/lemon8",
            "country_info": {
                "id": "US",
                "value": "United States",
                "label": "US"
            },
            "industry_info": {
                "id": 22000000000,
                "value": "Apparel & Accessories",
                "label": "label_22000000000"
            },
            "is_promoted": false,
            "trend": [
                {
                    "time": 1736121600,
                    "value": 0.51
                },
                ...
            ],
            "publish_cnt": 33723,
            "video_views": 109725286,
            "publish_cnt_all": 845759,
            "video_views_all": 11525091465,
            "longevity": {
                "popular_days": 0,
                "current_popularity": 0
            },
            "audience_interests": [
                {
                    "interest_info": {
                        "id": "10095",
                        "label": "diversify_10095",
                        "value": "Software & APPs"
                    },
                    "score": 144
                },
                ...
            ],
            "audience_countries": [
                {
                    "country_info": {
                        "id": "1861060",
                        "label": "JP",
                        "value": "Japan"
                    },
                    "score": 687
                },
                {
                    "country_info": {
                        "id": "6252001",
                        "label": "US",
                        "value": "United States"
                    },
                    "score": 587
                },
                ...
            ],
            "related_hashtags": [
                {
                    "hashtag_id": "7215354503279673386",
                    "hashtag_name": "lemon8us",
                    "video_url": "https://www.tiktok.com/tag/lemon8us"
                },
                ...
            ],
            "related_items": [
                {
                    "item_id": 7457131733473955000,
                    "cover_uri": "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068c799-us/o4GfQgAX6QqfbMFAMmi6zegGagGfM86Kof17s6~tplv-noop.image?x-expires=1736792067&x-signature=4zr4A1oDQPJ%2BhjRGSD7Zud5AyO8%3D"
                },
                ...
            ],
            "audience_ages_readable": [
                {
                    "age_range": "18-24",
                    "score": 52
                },
                {
                    "age_range": "35+",
                    "score": 25
                },
                {
                    "age_range": "25-35",
                    "score": 23
                }
            ]
        }
}
```

#### Hashtag analytics only

Retrieve detailed analytics for a custom list of hashtags.

```json
{
    "result_type": "analytics",
    "country": "US",
    "analytics_period": "30",
    "hashtags": ["lemon8", "lemonade", "lemonadechallenge"]
}
```

If a hashtag you provide is not popular enough (in this country and period), TikTok will not return any data for this hashtag.

## Insights that hashtag analytics can provide

### Interest over time

Each data point compares the relative volume against the peak volume of the trend. A value of 100 is the peak popularity for the trend.

### Audience insights

Information about viewers that watch videos associated with this trending hashtag.

#### Age range

The approximate percentage of viewers associated with different age ranges. Only available for age ranges above 18 years old.

#### Related interests

The top interests associated with viewers of this trend. The value represents an index score. Example: If the score is 200, the interest category is 2x as popular with viewers of this trend compared to its average popularity on TikTok worldwide.

#### Regional popularity

The top locations in the world where this term is most popular. The value represents an index score. Example: If the score is 200, the trend is 2x as popular in this market compared to its average popularity on TikTok worldwide.

#### Related videos

Trending videos that use this hashtag in the selected region and time frame.

#### Related hashtags

Trending hashtags that are related to this hashtag.

#### Trending creators

Trending creators who post this hashtag.

# Actor input Schema

## `result_type` (type: `string`):

Select the type of result you want to actor to retrieve.
Top 100 ranking only.
Top 100 ranking including hashtag analytics.
Hashtag analytics for a custom list of hashtags.

## `country` (type: `string`):

Select the country (or All for global) for which you want to retrieve the top 100 ranking / hashtag analytics.

## `top100_period` (type: `string`):

Select the period for which you want to retrieve the top 100 ranking.

## `analytics_period` (type: `string`):

Select the period for which you want to retrieve the hashtag analytics.

## `top100_industry` (type: `string`):

Filter top 100 ranking by industry.

## `top100_new_on_board` (type: `boolean`):

For top 100 ranking, only return entries that are new to the top 100 for this period.

## `hashtag_list` (type: `array`):

List of hashtags for which you want to retrieve analytics.

## Actor input object example

```json
{
  "result_type": "top100",
  "country": "ALL",
  "top100_period": "7",
  "top100_new_on_board": false
}
```

# 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 = {
    "result_type": "top100"
};

// Run the Actor and wait for it to finish
const run = await client.actor("codebyte/tiktok-trending-hashtags-analytics").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 = { "result_type": "top100" }

# Run the Actor and wait for it to finish
run = client.actor("codebyte/tiktok-trending-hashtags-analytics").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 '{
  "result_type": "top100"
}' |
apify call codebyte/tiktok-trending-hashtags-analytics --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,codebyte/tiktok-trending-hashtags-analytics"
        }
    }
}
```

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/iegmveuLh4C0XH7Hc/builds/7u6fAWGPKpe5dkQNa/openapi.json