Get a TikTok hashtag's stats

POST/v1/tools/tiktok.hashtag.detail/callsNeeds an API key

Returns a TikTok hashtag's description and its video and view counts. Use it to size a hashtag and get the ID that tiktok.hashtag.videos takes.

Tool tiktok.hashtag.detail on TikTok. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

hashtagstringRequired

The hashtag, without the

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`hashtag`

One object. Can be null.

idstringRequired

TikTok's numeric identifier of the hashtag, as a string, which tiktok.hashtag.videos takes as hashtag_id.

namestringRequired

The hashtag, without the

descriptionstring

The hashtag's description, when TikTok gives it one.

image_urlstring

Address of the hashtag's image.

video_countinteger

Number of videos posted with the hashtag.

view_countinteger

Number of times the hashtag's videos were played, in all.

curl https://api.voxoria.ai/v1/tools/tiktok.hashtag.detail/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"hashtag":"coffee"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/tiktok.hashtag.detail/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"hashtag": "coffee"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/tiktok.hashtag.detail/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"hashtag": "coffee"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "tiktok.hashtag.detail",
    "input": {
      "hashtag": "coffee"
    }
  }
}

200 OKoutputapplication/json

{
  "hashtag": {
    "id": "14104",
    "name": "coffee",
    "description": "We're celebrating International Coffee Day! Share your favourite coffee hacks, recommendations and stories with us!",
    "image_url": "https://p16-common-sign.tiktokcdn.com/tiktok-obj/24552381a53125ba59471c5cb8b75ed1.png~tplv-tiktokx-origin.image?dr=14566&x-expires=1793181600&x-signature=j5%2FuFmUMqNSkIycLMuk4nhJTFc4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=9b759fb9&idc=my",
    "video_count": 24118207,
    "view_count": 207160478870
  }
}

The output of a real call, each list cut to 3 items.