> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegoro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instagram hashtag

> Posts or reels carrying a given Instagram hashtag, with captions, engagement counts, and author handles.

Posts or reels carrying a given Instagram hashtag, with captions, engagement counts, and author handles.

<Note>Use when you need to track a hashtag or campaign, find creators posting about a topic, or gauge how much traction a tag is getting.</Note>

## Price

**\$0.0069 per result.** That is the rate you pay for each result the call returns, so the total depends on how many it produces.

Billing follows actual usage, so a call that returns fewer results costs less. `discover` and `inspect` also return a ceiling for your specific request, which is a maximum you will never be charged above.

## Input

| Field           | Type                        | Required | Notes                                                                                                                                                           |
| --------------- | --------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `hashtags`      | `array`                     | yes      | Hashtag or keyword to scrape. One per call: resultsLimit applies per hashtag, so batching several would bill past this request's hold. A leading # is optional. |
| `resultsType`   | `posts`, `reels`, `stories` |          | Defaults to `"posts"`.                                                                                                                                          |
| `resultsLimit`  | `integer`                   |          | Maximum results per hashtag or keyword Defaults to `20`.                                                                                                        |
| `keywordSearch` | `boolean`                   |          | Treat entries as free-text keywords rather than hashtags                                                                                                        |

<Note>
  Goro forwards your input to the underlying tool unchanged, so any field the
  tool accepts works here even if it is not listed above.
</Note>

## Example

```bash theme={null}
curl -X POST https://api.usegoro.ai/v1/run \
  -H "Authorization: Bearer $GORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"instagram.hashtag","input":{"hashtags":["example"],"resultsLimit":3}}'
```

## Response

One row of the response. Values are illustrative.

```json theme={null}
{
  "id": "3401234567890123457",
  "url": "https://instagram.com/example-account/DLMabcXYZ12/",
  "type": "Video",
  "likes": 9821,
  "caption": "morning routine that actually stuck #productivity",
  "comments": 231,
  "shortcode": "DLMabcXYZ12",
  "timestamp": "2026-07-02T08:30:00.000Z",
  "display_url": "https://example.com/media/sample.jpg",
  "owner_username": "dailyhabits"
}
```