# Instagram Search Mentions API (https://www.socialcrawl.dev/platforms/instagram/search-mentions)

> Returns Instagram posts by other accounts that tag an account or @mention it in the caption. Each call runs two searches: the account's Tagged tab (/v1/instagram/tagged, `match_kind` `tag`) and reels whose caption mentions `@handle` (/v1/instagram/search/reels, kept only when the caption carries the @handle or links the profile, `match_kind` `mention` or `link`). The Tagged tab is the one Instagram surface for posts that tag an account, and an account that approves its tags by hand can show older posts there, which is why the caption search runs as well. The account's own posts are left out unless `include_self=true`. Rows are merged newest first and a post found twice appears once. Each row in `data.items` is exactly the row the named search endpoint returns, with its `post` and `computed` blocks, plus `match_kind`. `since` and `until` keep only rows published inside the window. Send `data.next_cursor` back as `cursor` for the next page; it is null when every search has run out. `data.legs` reports each search: its endpoint, status, rows returned and kept, credits and `request_id`. `data.excluded` counts the rows left out (`unmatched`, `self`, `duplicate`, `outside_window`). Each call is one page of each search at its own price: 5 credits for the Tagged page and 1 for the reels page, so at most 6.

TL;DR: `GET /v1/instagram/search/mentions` costs Metered, 0-6 credits: each call reads one page of /v1/instagram/tagged (5 credits) and /v1/instagram/search/reels (1 credit), each billed at that endpoint's own price exactly as a direct call is. A page that found nothing or failed costs nothing, and a page served from cache is free. A page is billed when it returned rows, even if none of them carried the mention; data.legs shows each page's charge and data.excluded what was left out. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `handle` | yes | The account's username, with or without the @, or its profile URL. |
| `cursor` | no | data.next_cursor from the previous response, sent back verbatim for the next page. |
| `since` | no | Only posts published on or after this date, YYYY-MM-DD (UTC). |
| `until` | no | Only posts published on or before this date, YYYY-MM-DD (UTC); that whole day is included. |
| `include_self` | no | When true, also keep posts by the account itself. Default false. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/instagram/search/mentions" \
  --data-urlencode "handle=myntra" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Instagram Search Mentions API return?

Returns Instagram posts by other accounts that tag an account or @mention it in a reel caption, merged newest first, each labelled tag, mention or link. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Instagram Search Mentions endpoint?

Use it to track who tags or mentions a brand on Instagram, including brands whose Tagged tab is curated; since/until keep rows inside a date window.

### How much does the Instagram Search Mentions API cost?

The price depends on the request, from 0 to 6 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Instagram Search Mentions API need?

The one required parameter is handle (the account's username, with or without the @, or its profile URL). It also accepts 4 optional parameters, all listed on this page.

### How do I call the Instagram Search Mentions API?

Send a GET request to https://www.socialcrawl.dev/v1/instagram/search/mentions?handle=myntra with your API key in the x-api-key header. An Authorization: Bearer header works too.

See the full Instagram API: https://www.socialcrawl.dev/platforms/instagram

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- What does the SocialCrawl Instagram Search Mentions API return?
- How do I get Instagram Search Mentions data with the SocialCrawl API?