# Search Instagram hashtags

Returns the Instagram hashtags that match a search, with their post counts. Use it to find which hashtags to follow.

Tool `instagram.search.hashtags` on Instagram. Contract version 1, released 2026-11-01.

## 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/instagram.search.hashtags/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"coffee"}}'
```

Python:

```python
import os

import httpx

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

TypeScript:

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

MCP (`tools/call` params):

```json
{
  "name": "call_tool",
  "arguments": {
    "tool": "instagram.search.hashtags",
    "input": {
      "query": "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 |
| --- | --- | --- | --- | --- |
| `query` | string | Yes |  | The search query, matched against hashtag names. |

## Output

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

### hashtags

A list of rows. Always present, possibly empty.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string | No | Instagram's numeric identifier of the hashtag, as a string. |
| `name` | string | Yes | The hashtag, without the |
| `post_count` | integer | No | Number of posts with the hashtag. |

## Example output

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

```json
{
  "hashtags": [
    {
      "id": "17841562927103039",
      "name": "coffeebar",
      "post_count": 1899840
    },
    {
      "id": "17843769469006655",
      "name": "coffeegram",
      "post_count": 9506674
    },
    {
      "id": "17841564106092657",
      "name": "coffeebreak",
      "post_count": 9694859
    }
  ]
}
```