# 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"
```

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