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

# Instagram Hashtag Analytics

> Extract Instagram hashtag stats: top/recent posts, volume, posts per day, related hashtags with frequency, from input hashtags

`$1.3 / 1k results`

Extract Instagram hashtag stats: top/recent posts, volume, posts per day, related hashtags with frequency, from input hashtags

## Endpoint

`POST /api/v1/agents/instagram/hashtag-analytics/run`

## Parameters

<ParamField body="hashtags" type="array" required>
  **List** · Instagram hashtags to pull analytics for, with or without the # symbol.
</ParamField>

## Response columns

| Field                 | Display name          | Type   |
| --------------------- | --------------------- | ------ |
| `hashtag`             | Hashtag               | text   |
| `hashtagUrl`          | Hashtag URL           | url    |
| `postsCount`          | Posts Count           | number |
| `relatedHashtag`      | Related Hashtag       | text   |
| `relatedHashtagPosts` | Related Hashtag Posts | text   |
| `frequentCoHashtag`   | Frequent Co-Hashtag   | text   |
| `averageCoHashtag`    | Average Co-Hashtag    | text   |
| `rareCoHashtag`       | Rare Co-Hashtag       | text   |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/instagram/hashtag-analytics/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "hashtags": [
        "webscraping",
        "marketing",
        "fashion",
        "fitness",
        "food",
        "travel",
        "photography",
        "tech",
        "startup",
        "design"
      ],
      "includeLatestPosts": true,
      "includeTopPosts": true
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/instagram/hashtag-analytics/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "hashtags": [
          "webscraping",
          "marketing",
          "fashion",
          "fitness",
          "food",
          "travel",
          "photography",
          "tech",
          "startup",
          "design"
      ],
      "includeLatestPosts": true,
      "includeTopPosts": true
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "hashtag": "webscraping",
      "hashtagUrl": "https://www.instagram.com/explore/tags/webscraping",
      "postsCount": 2574000,
      "relatedHashtag": null,
      "relatedHashtagPosts": null,
      "frequentCoHashtag": null,
      "averageCoHashtag": null,
      "rareCoHashtag": null
    }
  ]
}
```