# TikTok Hashtag Stats — Exact Counts, $0.50 per 1K (`funny_ground/tiktok-hashtag-stats`) Actor

Get exact TikTok hashtag video and view counts as full integers. Lightweight HTTP-only extraction needs no browser, login, proxy, or residential IP. Budget-friendly pay-per-result pricing: $0.50 per 1,000 hashtags.

- **URL**: https://apify.com/funny\_ground/tiktok-hashtag-stats.md
- **Developed by:** [Coor Yu](https://apify.com/funny_ground) (community)
- **Categories:** Social media, Videos
- **Stats:** 7 total users, 3 monthly users, 46.3% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $0.50 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## TikTok Hashtag Stats — Exact Counts, $0.50 per 1K

Enter TikTok hashtags and export the exact number of videos and cumulative views for each tag. Results also include TikTok's challenge ID, public description, and commerce classification.

Use it for trend tracking, campaign reporting, hashtag research, content planning, or comparing niche size.

### Why use this Actor

- Returns full integer counts instead of rounded `K`, `M`, `B`, or `T` labels.
- Processes many hashtags in one run.
- Uses lightweight HTTP only—no Chromium, login, proxy, or residential IP.
- Produces one simple, spreadsheet-ready row per hashtag.

### Budget-friendly pricing

- **$0.0005 per output hashtag — $0.50 per 1,000 hashtags.**
- A small start event and normal Apify platform usage may also apply; see the **Pricing** tab.
- Failed requests written as errors are visible for reconciliation.

### Quick start

```json
{
  "hashtags": [
    "roblox",
    "minecraft",
    "skincare"
  ],
  "maxConcurrency": 4,
  "requestTimeoutSecs": 10,
  "maxRequestRetries": 2
}
```

#### Input options

| Field | Default | What it does |
|---|---:|---|
| `hashtags` | required | Hashtags without `#`, one per line. |
| `maxConcurrency` | `4` | Concurrent lightweight tasks; requests are rate-limited automatically. |
| `requestTimeoutSecs` | `10` | Timeout for one HTTP request. |
| `maxRequestRetries` | `2` | Short retries for temporary upstream errors. |
| `proxyConfiguration` | disabled | Legacy field; ignored. No proxy is started. |

### Output

```json
{
  "hashtag": "roblox",
  "platform": "tiktok",
  "challenge_id": "159721",
  "video_count": 104000000,
  "view_count": 1515000000000,
  "description": "Explore #Roblox",
  "is_commerce_hashtag": false,
  "_source": "Lightweight public hashtag API (exact integers)",
  "error": null
}
```

### Cost-efficient architecture

Each hashtag normally needs one small JSON request. The Actor uses a lightweight Python runtime with a 256 MB default allocation instead of installing and starting Chromium. A global request gate respects the public endpoint's rate limit, while short retries handle temporary failures without long browser timeouts.

### 中文速览

输入 TikTok 话题标签，直接导出该标签的视频总数和累计播放量，均为完整整数。Actor 不开浏览器、不登录、不使用代理或住宅 IP；价格为 **每 1,000 个话题 $0.50**。

### Limitations and responsible use

- Counts are snapshots and can change after the run.
- The lightweight endpoint is maintained by an independent upstream provider, so availability and fields may change.
- Use public statistics in accordance with applicable laws and platform terms.

### Zero-result policy

A run that produces no valid hashtag-statistics rows finishes as `FAILED`. Diagnostics are stored in the `ERRORS` key-value-store record and never count as default-dataset results.

# Actor input Schema

## `hashtags` (type: `array`):

Hashtag names without #, one per line. Each result contains exact video and total-view counts.

## `maxConcurrency` (type: `integer`):

Maximum concurrent lightweight tasks. Requests are automatically rate-limited for stability.

## `requestTimeoutSecs` (type: `integer`):

Timeout for each lightweight HTTP request.

## `maxRequestRetries` (type: `integer`):

Retries for temporary upstream errors. The low default prevents wasted compute.

## `proxyConfiguration` (type: `object`):

Ignored for compatibility. This Actor is HTTP-only and never starts a proxy or residential IP.

## Actor input object example

```json
{
  "hashtags": [
    "roblox"
  ],
  "maxConcurrency": 4,
  "requestTimeoutSecs": 10,
  "maxRequestRetries": 2,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

TikTok hashtag summary rows from the default dataset, displayed with the overview table view.

# 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 = {
    "hashtags": [
        "roblox"
    ],
    "maxConcurrency": 4,
    "requestTimeoutSecs": 10,
    "maxRequestRetries": 2
};

// Run the Actor and wait for it to finish
const run = await client.actor("funny_ground/tiktok-hashtag-stats").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 = {
    "hashtags": ["roblox"],
    "maxConcurrency": 4,
    "requestTimeoutSecs": 10,
    "maxRequestRetries": 2,
}

# Run the Actor and wait for it to finish
run = client.actor("funny_ground/tiktok-hashtag-stats").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "hashtags": [
    "roblox"
  ],
  "maxConcurrency": 4,
  "requestTimeoutSecs": 10,
  "maxRequestRetries": 2
}' |
apify call funny_ground/tiktok-hashtag-stats --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=funny_ground/tiktok-hashtag-stats",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

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