[Integrations](https://spiral.ai/integrations) › [Hermes](https://spiral.ai/integrations/hermes) › [TikTok search topic statistics](https://spiral.ai/integrations/hermes/tiktok-search-topic-statistics)

# How to Use TikTok search topic statistics in Hermes

Returns search trends and audience demographics for a selected search topic. Use it to evaluate a topic's audience and search history; custom date ranges cannot exceed six months.

|  |  |
| --- | --- |
| Model | TikTok search topic statistics |
| Available through | TikHub |
| Category | Social Media |
| Price | $0.0013 per request. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok search topic statistics in Hermes

- Every Monday at 9am: use TikTok search topic statistics to look this up and give me the result as a table.
- Pull the latest numbers from TikTok search topic statistics and tell me what changed since last week.
- Check TikTok search topic statistics and summarize what you find in three bullet points.
- Pull the newest data from TikTok search topic statistics and give me the result as a table.
- Check TikTok search topic statistics every morning and tell me only when something changed.

## How to set up TikTok search topic statistics in Hermes

Pick the way that suits you. Each takes about two minutes.

### Use the Spiral skill

1. **Send Hermes this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use Spiral's MCP server

1. **Add the server and sign in**: Hermes opens your browser: sign in to Spiral and click Authorize. No API key. When Hermes asks Enable all tools? \[Y/n/select], answer Y: n cancels without saving the server, and select hides the tools you leave out.

```bash
hermes mcp add spiral \
  --url https://api.spiral.ai/mcp \
  --auth oauth \
  --connect-timeout 300
```

2. **Check it**: In a chat that was already open, run `/reload-mcp`.

```bash
hermes mcp list
hermes mcp test spiral
```

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run TikTok search topic statistics**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "tikhub",
    "model": "tikhub/tiktok-app-v3-fetch-creator-search-insights-detail",
    "input": {
      "query_id_str": "122991006"
    }
  }'
```

Then paste one of the prompts above: Hermes finds TikTok search topic statistics on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/hermes

## TikTok search topic statistics tools and prices

- [TikTok App · Creator Search Insights Detail](https://spiral.ai/tools/tikhub/tikhub/tiktok-app-v3-fetch-creator-search-insights-detail) (TikHub): $0.0013 per request.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| end_date |  | — | End timestamp (seconds), only for custom range |
| start_date |  | — | Start timestamp (seconds), only for custom range |
| time_range |  | past_30_days | Time range (past_7_days/past_30_days/past_60_days/past_6_months/custom) |
| dimension_list |  | gender,age,country | Dimension list (gender/age/country) |

## What can you do with TikTok search topic statistics in Hermes?

Keep a recurring TikTok research digest for a product category or public campaign. Scheduled retrievals can assemble new reports from search and hashtag results, with translated text for a multilingual team.

### Prepare a multilingual product launch brief

Research a product category through keyword results, matching hashtags, hashtag details, and hashtag videos. Add search topics, their statistics, regional trends, and related videos; review public shopping creator information and translate selected text for the launch team.

### Build an editorial calendar for a retail category

Use search insights, topic statistics, and regional trends to propose subjects. Ground each proposal in keyword results, hashtag research, and related video examples; add potential shopping collaborators and translations of relevant text.

### Plan a seasonal retail campaign

Compare seasonal search topics using their statistics, geographic interest, and related videos. Combine keyword and hashtag research with public shopping creator information, then translate selected phrases for a campaign planning brief.

### Write a creator partnership brief

Combine a public shopping creator's storefront and audience counts with category keyword results and hashtag details and videos. Use search insights, topic statistics, regional trends, and related videos to suggest subjects, translating selected text for collaborators.

### Find subjects for a cooking series

Discover food search topics, inspect their search statistics and regional trends, and collect related popular videos as references for episode proposals.

## Overview

- [TikHub](https://spiral.ai/providers/tikhub)
- [All Hermes guides](https://spiral.ai/integrations/hermes)

## TikTok search topic statistics in other agents

- [Amp](https://spiral.ai/integrations/amp/tiktok-search-topic-statistics)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/tiktok-search-topic-statistics)
- [Claude](https://spiral.ai/integrations/claude-desktop/tiktok-search-topic-statistics)
- [Claude Code](https://spiral.ai/integrations/claude-code/tiktok-search-topic-statistics)
- [Cline](https://spiral.ai/integrations/cline/tiktok-search-topic-statistics)
- [Codex](https://spiral.ai/integrations/codex/tiktok-search-topic-statistics)
- [Cursor](https://spiral.ai/integrations/cursor/tiktok-search-topic-statistics)
- [Devin](https://spiral.ai/integrations/devin/tiktok-search-topic-statistics)
- [dots](https://spiral.ai/integrations/dots/tiktok-search-topic-statistics)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/tiktok-search-topic-statistics)
- [Gemini](https://spiral.ai/integrations/gemini/tiktok-search-topic-statistics)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/tiktok-search-topic-statistics)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/tiktok-search-topic-statistics)
- [goose](https://spiral.ai/integrations/goose/tiktok-search-topic-statistics)
- [Grok](https://spiral.ai/integrations/grok/tiktok-search-topic-statistics)
- [Grok Build](https://spiral.ai/integrations/grok-build/tiktok-search-topic-statistics)
- [Instinct](https://spiral.ai/integrations/instinct/tiktok-search-topic-statistics)
- [Manus](https://spiral.ai/integrations/manus/tiktok-search-topic-statistics)
- [Muse](https://spiral.ai/integrations/muse/tiktok-search-topic-statistics)
- [Muse Code](https://spiral.ai/integrations/muse-code/tiktok-search-topic-statistics)
- [n8n](https://spiral.ai/integrations/n8n/tiktok-search-topic-statistics)
- [Notion](https://spiral.ai/integrations/notion/tiktok-search-topic-statistics)
- [OpenClaw](https://spiral.ai/integrations/openclaw/tiktok-search-topic-statistics)
- [opencode](https://spiral.ai/integrations/opencode/tiktok-search-topic-statistics)
- [Perplexity](https://spiral.ai/integrations/perplexity/tiktok-search-topic-statistics)
- [Raycast](https://spiral.ai/integrations/raycast/tiktok-search-topic-statistics)
- [VS Code](https://spiral.ai/integrations/vscode/tiktok-search-topic-statistics)
- [Windsurf](https://spiral.ai/integrations/windsurf/tiktok-search-topic-statistics)
- [Zapier](https://spiral.ai/integrations/zapier/tiktok-search-topic-statistics)

## More Hermes guides

- [TikTok search suggestions](https://spiral.ai/integrations/hermes/tiktok-search-suggestions)
- [TikTok search topic trends](https://spiral.ai/integrations/hermes/tiktok-search-topic-trends)
- [TikTok search results](https://spiral.ai/integrations/hermes/tiktok-search-results)
- [TikTok search topic videos](https://spiral.ai/integrations/hermes/tiktok-search-topic-videos)
- [TikTok recommended LIVE rooms](https://spiral.ai/integrations/hermes/tiktok-recommended-live-rooms)
- [TikTok shopping creator information](https://spiral.ai/integrations/hermes/tiktok-shopping-creator-information)

## Questions about TikTok search topic statistics in Hermes

**Can Hermes use TikTok search topic statistics?**

Yes. Add Spiral to Hermes as an MCP server, and Hermes can find and run TikTok search topic statistics like any built-in tool.

**How much does TikTok search topic statistics cost in Hermes?**

$0.0013 per request. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Hermes plan is separate.

**Do I need a TikHub account to use TikTok search topic statistics in Hermes?**

No. Spiral runs TikTok search topic statistics on its own TikHub account. You sign in to Spiral once and never paste a key.

**How long does it take to set up TikTok search topic statistics in Hermes?**

About two minutes: add the server and sign in, then check it.

**Does Hermes wait while TikTok search topic statistics runs?**

TikTok search topic statistics runs in the background. Hermes starts the run, checks on it and gives you the json when it's ready.

**Does TikHub return private TikTok content?**

TikHub's privacy policy says it does not access or store private, restricted, or password-protected platform content. Public availability is the access boundary.

**How fresh is TikHub's data?**

TikHub describes repeat requests as fresh, real-time retrievals. Its terms still disclaim guarantees that the returned data is current.

**Does TikHub guarantee complete or accurate results?**

No. TikHub's terms explicitly disclaim guarantees that retrieved data is accurate, complete, or current.

**Can retrieved TikTok content be reused freely?**

TikHub's terms say retrieved content may carry third-party intellectual property rights. Retrieval does not establish permission to republish a creator's work.

**Does TikHub document every returned data field?**

No. TikHub says its responses vary by platform and its documentation describes endpoints and parameters rather than every payload key.

