Instagram Profile Posts API reference

Instagram username without the @ symbol

Only posts published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Older posts 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 posts 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 post you already hold. The page stops just before it: that post and everything after it are left off, next_cursor is not returned, and pagination.stopped_at is known_id. A pinned post 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. The differences trim itself makes are that post.ext.coauthors is omitted and post.flags.pinned is null, because the trimmed record carries neither signal; every other canonical field is still returned. Trim does not affect the two record widths described above, which vary per row in both modes.

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.

Photos and carousels are never looked up.

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.