---
title: "Instagram"
description: "Public Instagram posts and reels naming your keyword in their caption or hashtags."
canonical: https://docs.mentio.dev/platforms/instagram
markdown: https://docs.mentio.dev/platforms/instagram.mdx
---

# Instagram

Public Instagram posts and reels naming your keyword in their caption or hashtags.

Instagram's own search lists popular posts, not new ones, so Mentio reads Instagram two ways: new captions through public web search, up to twice a day, and, for a one-word keyword, every new post under its hashtag.

| `platform`                 | `instagram`                                                                                                                                                                                                 |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| What is found              | Captions and hashtags of public posts and reels                                                                                                                                                             |
| Freshness                  | Twice a day for a one-word keyword's hashtag and for captions, a few hours after posting. A new keyword's first caption search runs after about half a day and reaches back to when the keyword was created |
| Look-back on a new keyword | Yes, the newest 10 of the last 7 days                                                                                                                                                                       |

## Track it [#track-it]

Create a keyword limited to Instagram. Leave `platforms` out to search every platform.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/keywords', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "term": "Acme",
    "kind": "brand",
    "platforms": [
      "instagram"
    ]
  }),
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.post(
    "https://api.mentio.dev/v1/keywords",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
    json={
      "term": "Acme",
      "kind": "brand",
      "platforms": [
        "instagram"
      ]
    },
)
print(response.json())
```

cURL:

```bash
curl -X POST "https://api.mentio.dev/v1/keywords" \
  -H "Authorization: Bearer $MENTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "term": "Acme",
  "kind": "brand",
  "platforms": [
    "instagram"
  ]
}'
```

## Read its mentions [#read-its-mentions]

Filter the mentions list to Instagram. `relevant=true` keeps what the classifier scored about you.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/mentions?platforms=instagram&relevant=true', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
  },
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.get(
    "https://api.mentio.dev/v1/mentions?platforms=instagram&relevant=true",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
)
print(response.json())
```

cURL:

```bash
curl -X GET "https://api.mentio.dev/v1/mentions?platforms=instagram&relevant=true" \
  -H "Authorization: Bearer $MENTIO_API_KEY"
```

Response (trimmed):

```json
{
  "data": [
    {
      "id": "mm_8f2k1x9q",
      "status": "open",
      "relevant": true,
      "keyword": {
        "id": "kw_123",
        "term": "Acme"
      },
      "post": {
        "publishedAt": "2026-11-07T14:32:10.000Z",
        "platform": "instagram",
        "kind": "post",
        "url": "https://www.instagram.com/p/DBx1aBcDeFg/",
        "text": "Our new desk setup, powered by Acme ☕ #acme #remotework",
        "engagement": {
          "likes": 412,
          "replies": 17
        }
      },
      "author": {
        "name": "Studio North",
        "handle": "studionorth",
        "url": "https://www.instagram.com/studionorth"
      },
      "classification": {
        "relevance": 82,
        "sentiment": "positive",
        "intents": [
          "praise"
        ],
        "note": "A user recommends Acme by name."
      }
    }
  ],
  "nextCursor": "eyJ0IjoxNzMxMDAwMDAwfQ"
}
```

## What a mention carries [#what-a-mention-carries]

* `post.text`: the caption, hashtags it does not spell out, and the search snippet (for a reel, often what is said).
* `post.engagement`: likes and comments (as replies), and views where Instagram gives them.
* `author`: name and profile link. No avatar and no follower count.

The rest is the same on every platform: relevance, sentiment and intent from the classifier, your triage, and the keyword it matched. See the [mention shape](/api).

## Mute an author [#mute-an-author]

`instagram.com/name`, or a handle. A post or reel link is refused: it does not name its author. See [Mute authors](/alerts#mute-authors).

## Limits [#limits]

* Only a one-word keyword gets the hashtag feed; a phrase is found through captions alone.
* Search lists a post 7 to 24 hours after it was published, so a caption match can arrive a day late.
* Keywords created before Instagram was added (September 2026) keep the platforms they had: turn Instagram on per keyword.