Public posts from other accounts that @mention a handle, newest first. The same post shape as a profile's own feed, so mentions and posts join without remapping.
| parameter | type | description |
|---|---|---|
| handle | string, required | The Instagram username, without the @. |
| limit | integer | Items per page, up to 50 synchronously. Above that the call becomes a job. |
| cursor | string | meta.next_cursor from the previous page. |
| fresh | boolean | Skip the stored copy and read live, at the same price. |
| fields | string | Comma-separated field paths to keep. |
| format | json, csv | CSV flattens each item to one row. |
1 credit per post. Failed calls are never charged, and empty results are free up to 25 a day. Stored copies are refreshed every 3 hours.
A page of posts, each with its id, URL, type, caption, counts, duration for video, timestamp and author. Pass limit and cursor to page.
Only public posts that Instagram surfaces as mentions of the handle are returned. The account's own posts are not; use profile posts for those.
curl "https://api.instadata.dev/v1/instagram/mentions?handle=nasa&limit=10" \ -H "Authorization: Bearer ik_live_..."
{
"data": [ … ],
"meta": { "count": …, "limit": …, "next_cursor": "…" },
"request_id": "req_01J…"
} | field | type | note |
|---|---|---|
| id | string | The post's shortcode, as in its URL. |
| url | string | Canonical post URL. |
| type | string|null | Image, Video, Sidecar (carousel) or the product type Instagram reports. |
| caption | string|null | The caption as written, hashtags included. |
| views | number|null | Play count for video; null for images and carousels. |
| likes | number|null | Null when the creator hides like counts. |
| comments | number|null | Comment count. |
| shares | number|null | Share count when Instagram publishes it on the row; usually null. |
| duration_sec | number|null | Video length in seconds; null for images. |
| posted_at | string|null | ISO 8601 timestamp. |
| author | object | { handle, name } of the account that posted the mention. |
A public post whose caption @mentions the handle. Comments that mention the handle are not posts and are not returned.
Charged per post returned. An empty page is free up to the daily allowance.
Up to 50 per synchronous call, more as a job. Page with the cursor; the rows arrive newest first.
No. The endpoint returns public posts whose captions mention the handle. Comment text is a separate call per post.
Yes. The same field names come back, so mentions, tagged posts and a profile's own posts can be joined on id without remapping.