# Get a TikTok hashtag's stats

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.

## Example call

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

cURL:

```bash
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"}}'
```

Python:

```python
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())
```

TypeScript:

```ts
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());
```

MCP (`tools/call` params):

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

Both return [the full response](/docs/call-response.md): the call's ID, status and cost, with this tool's result in `output`.

## Input

| Input | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `hashtag` | string | Yes |  | 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`.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | Yes | TikTok's numeric identifier of the hashtag, as a string, which tiktok.hashtag.videos takes as hashtag_id. |
| `name` | string | Yes | The hashtag, without the |
| `description` | string | No | The hashtag's description, when TikTok gives it one. |
| `image_url` | string | No | Address of the hashtag's image. |
| `video_count` | integer | No | Number of videos posted with the hashtag. |
| `view_count` | integer | No | Number of times the hashtag's videos were played, in all. |

## Example output

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

```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
  }
}
```