# solari fetch instagram hashtag search

> Find hashtags by keyword, with their sizes.

- **CLI**: `solari fetch instagram hashtag search`
- **MCP tool**: `solari_fetch_instagram_hashtag_search`
- **Access**: `solari:read` — Works with any signed-in SOLARI account.
- **Required plan**: Free
- **Credit**: 0

Look hashtags up on Instagram by keyword and see how many posts each one has. Nothing is stored.

**When to use it** — When you need the exact spelling or the biggest variant of a tag before reading or collecting it.

**What comes back** — Up to 20 hashtags with the post count Instagram reports.

## Parameters

- `query` (string, required, ≤ 100 chars) — Keyword, with or without #.

## Response

### `Response`

- `query` (string) — The keyword the lookup ran on.
- `hashtags` (object[]) — Matching hashtags, best match first.
- `found` (integer) — Hashtags returned.

### `hashtags[]`

- `name` (string) — Hashtag without #.
- `post_count` (integer | null) — Posts Instagram reports under it.

## Example

```console
$ solari fetch instagram hashtag search query=skincare
```

_Long strings and repeated array entries are trimmed for readability._

```json
{
  "query": "skincare",
  "hashtags": [
    {
      "name": "skincare",
      "post_count": 128000000
    },
    {
      "name": "skincareroutine",
      "post_count": 31000000
    },
    {
      "name": "skincaretips",
      "post_count": 9400000
    }
  ],
  "found": 3
}
```

## As an MCP call

```json
{
  "name": "solari_fetch_instagram_hashtag_search",
  "arguments": {
    "query": "skincare"
  }
}
```

## Notes

- post_count is Instagram's own total, not the number of posts SOLARI has collected.
- There is no pagination: Instagram returns at most 20 candidates.

## Related tools

- [`solari_fetch_instagram_hashtag_posts`](https://finder-dev-pub.bzine.co/docs/tools/fetch-instagram-hashtag-posts.md)
- [`solari_catalog_instagram_tag_search`](https://finder-dev-pub.bzine.co/docs/tools/catalog-instagram-tag-search.md)