Instagram Profile Reels API reference

Instagram user id. Use this for faster response times. Provide at least one of: user_id, handle.

Instagram username without the @ symbol. Provide at least one of: user_id, handle.

Only reels published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Older reels are left off the page, and the page that reaches one ends the walk: next_cursor is not returned and pagination.stopped_at is since. Pinned reels sit out of date order and never end the walk. The page still costs what a page costs, so a daily poll pays for the pages it walks and no more.

The id (post.id) or URL (post.url) of the newest reel you already hold. The page stops just before it: that reel and everything after it are left off, next_cursor is not returned, and pagination.stopped_at is known_id. A pinned reel never counts as the stop point. If it is not on this page the page is returned in full with its cursor, so keep walking. pagination.stopped_at is end when the list ran out first and null while there is more to walk.

Set to true to request the lighter record: a smaller, faster page that keeps the engagement, the author, the caption, the timestamp and the reel URL. What it drops is post.content.media_urls (the video file), post.content.duration_seconds, post.ext.coauthors and post.flags.pinned. The cover image is returned as post.content.thumbnail_url either way. Leave it unset when you need the video URL or the duration.

Set to true to leave out the posts the owner pinned to the top of the profile. A row whose pin state is unknown, which is every row with trim=true, is kept.

Keep only posts published in the last N days (1 to 3650). Older posts are removed from the page, pinned ones included, and once a page reaches posts older than the window next_cursor is not returned, so a walk back to a date window stops on its own. The page still costs what a page costs.

stats returns the full stat line on every reel: engagement.shares, engagement.saves and post.ext.repost_count beside views, likes, comments, the remix counter, post.ext.music_id for original sounds and licensed music alike, and post.ext.audio_cluster_id, Instagram's audio cluster for the reel. It is served by a second source, so a cursor from a request without it cannot continue a walk with it; start from page 1. Both tokens can be combined (include=audio,stats).

Set to 1 to get the price of this call without making it: data.dry_run carries credits_min and credits_max. Nothing is charged.

The pagination.next_cursor from the previous page, sent back unchanged. Omit it for the first page.