Comments across a profile's recent posts in one call, each row carrying the post it was left on. The fastest way to read what an audience is saying to an account without walking its feed post by post.
| 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 comment. Failed calls are never charged, and empty results are free up to 25 a day. Stored copies are age-aware, 15 minutes to 7 days.
A page of comments. Each row has the comment text, its author, its timestamp and a post object with the post's id, URL, caption and date. limit sets how many comments come back; the call reads as many recent posts as needed to fill it, about ten comments per post.
Comment ids and like counts are not published on these rows and are null.
curl "https://api.instadata.dev/v1/instagram/profile-comments?handle=nasa&limit=10" \ -H "Authorization: Bearer ik_live_..."
{
"data": [ … ],
"meta": { "count": …, "limit": …, "next_cursor": "…" },
"request_id": "req_01J…"
} | field | type | note |
|---|---|---|
| id | null | Not published on these rows. |
| text | string | The comment as written. |
| author | string|null | Handle of the commenter. |
| author_avatar | string|null | Profile picture URL of the commenter; short-lived. |
| likes | null | Not published on these rows. |
| posted_at | string|null | ISO 8601 timestamp of the comment. |
| post | object | { id, url, caption, posted_at } of the post the comment is under. |
The call reads the newest posts and takes up to ten comments from each until limit is reached. For a complete thread under one post, use the Comments endpoint with that post's URL.
Charged per comment row returned.
Comments reads one post by URL and returns full rows with ids and like counts. Profile Comments reads a handle and returns a sample of comments across its recent posts, each tagged with its post, without ids or like counts.
About one post per ten comments requested. limit=50 reads the five newest posts and returns up to ten comments from each.
1 credit per comment returned. Empty results are free up to the daily allowance.