> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_instagram_hashtag

# get_instagram_hashtag

> Public Instagram posts under a hashtag: caption, likes, comments, author and date. ₹0.29 per page; a hashtag with no posts is ₹0.

## What it does

Public posts under one hashtag: `data.data.items[]` with `code`, `caption_text`, `taken_at`, `like_count`, `comment_count`, `play_count`, `product_type`, `is_paid_partnership` and `user`, about two dozen a page, with `data.pagination_token` for more. `feed_type` picks `top`, `recent` or `reels`.

A post's address is `instagram.com/p/` followed by its `code`. There are no images or video links, which keeps the answer small: the source's answer is about 350 KB a page, and this is about 17 KB. [`get_instagram_post`](https://parel.si/docs/tools/get_instagram_post.md) gives one post in full, and [`get_instagram_comments`](https://parel.si/docs/tools/get_instagram_comments.md) its comments.

India: send the tag as people write it.

## Inputs

Generated from the contract captured from staging on 2026-11-05.

| Field | Type | Required | Description |
|---|---|---|---|
| `hashtag` | string | yes | The hashtag, with no #. |
| `feed_type` | string | no | top (the default), recent, or reels. |
| `page_token` | string | no | pagination_token from the last answer, for the next page. |

## What drives the cost

Flat per page, usually five to fifteen seconds. A hashtag with no posts is `class: "ok_free"`, ₹0.

## Price today

| | |
|---|---|
| Price today | **₹0.29** per page (`cost_paise: 29`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.44 (`hold_paise: 44`); when the call settles the real price is charged and the unused part is released |
| ₹0 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 40 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_instagram_hashtag"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_instagram_hashtag"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_instagram_hashtag","input":{"hashtag":"mamaearth","feed_type":"top"}}'
```

## What comes back

`data.data.items[]`. A real answer recorded during the live check of 2026-11-05, trimmed to two posts, with the authors replaced:

```json
{
  "data": {
    "count": 2,
    "items": [
      {
        "code": "Db8nWdZBnDA",
        "caption_text": "Buy one Get one sale. \n\n#mamaearth #mamaearthindia #mamaearthb1g1 #skincaresale #buy1get1free \n\nMamaearth b1g1 sale, mam…",
        "taken_at": "2026-08-12T16:50:50Z",
        "like_count": 931,
        "comment_count": 205,
        "play_count": 86971,
        "view_count": 0,
        "product_type": "clips",
        "is_paid_partnership": true,
        "user": {
          "username": "example_user_1",
          "full_name": "Example User",
          "is_verified": false
        }
      },
      {
        "code": "DfUY7FqgVEy",
        "caption_text": "Want a brighter skin go and get a mamaearth rice face wash 🤍\n#skincare#loveyourself#nomakeup\n#mamaearth",
        "taken_at": "2026-11-04T11:52:45Z",
        "like_count": null,
        "comment_count": 6,
        "play_count": 1191,
        "view_count": 0,
        "product_type": "clips",
        "is_paid_partnership": false,
        "user": {
          "username": "example_user_2",
          "full_name": "Example User",
          "is_verified": false
        }
      }
    ]
  },
  "pagination_token": "Dk1bBDYpExZEZRU2Cy59KQwxHC0tJx…"
}
```

## Notes

- Flat price per page; a hashtag that does not exist is free.
- Usually five to fifteen seconds.
- Build a post's address from its code: instagram.com/p/<code>.

## Siblings

- [`search_instagram_users`](https://parel.si/docs/tools/search_instagram_users.md) to find accounts.
- [`get_instagram_post`](https://parel.si/docs/tools/get_instagram_post.md) for one post in full.
- [`get_instagram_comments`](https://parel.si/docs/tools/get_instagram_comments.md) for a post's comments.
