App Logo
instagram.com

Get Instagram DM inbox

Automatically get Instagram DM inbox on instagram.com. List the state of every DM conversation in your Instagram inbox. count=0 fetches every page. Returns count, unseen_count, and threads (thread_id, title, users, is_group, unread, last_activity_at, last_activity (ISO), last_message). Each last_message has sent_by_me (you vs them), date (ISO), type, and text. thread_id is the join key for reading a conversation's messages.

Input

count optional

Max conversations to fetch; 0 = every page Instagram serves.

Default: 20
since optional

Optional ISO datetime. Stop loading older pages once a conversation older than this is reached: this is how a caller polls for new messages. Every conversation read is returned, including the few older ones on the last page read; compare last_activity against since to keep the new ones. reached_since says whether the cutoff was reached.

Output

count required
threads required
unseen_count optional
reached_since optional

Only set when `since` was given. True means pagination walked back past the cutoff, so every conversation newer than it was seen. False means the inbox was exhausted (or no older page existed) first.

FAQ

List the state of every DM conversation in your Instagram inbox. count=0 fetches every page. Returns count, unseen_count, and threads (thread_id, title, users, is_group, unread, last_activity_at, last_activity (ISO), last_message). Each last_message has sent_by_me (you vs them), date (ISO), type, and text. thread_id is the join key for reading a conversation's messages.
Ask an AI agent connected to Reduck to run reduck/instagram.com/get_inbox, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/instagram.com/get_inbox
You do not need one. "Get Instagram DM inbox" drives the real instagram.com pages in a browser, so it works whether or not instagram.com offers an API for this.
Optional: count, since.
It returns count, threads, unseen_count, reached_since.
Yes. It acts as you on instagram.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the instagram.com cookies saved by the Reduck extension.
It only reads. It looks things up on instagram.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/instagram.com/get_inbox, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/instagram.com/get_inbox
It is part of Reduck's official curated catalogue.

Related scripts

instagram.com

Send Instagram DM

Send a DM to an Instagram user by their username: plain text, an image attachment, or both together. Takes the image as base64 so it runs from any client. Returns ids/timestamps for whichever parts were sent, and the recipient-side restriction banner if one is shown right after sending.

instagram.com

Get Instagram post comments

Fetch the preview comments of an Instagram post or reel by shortcode, plus its caption and counts. Returns code, url, caption, comments (text, user, verified, created_at, like_count, reply_count), like_count, view_count, comment_count, and comments_disabled. Only returns the comments Instagram renders by default, not the full thread, capped to count.

instagram.com

Delete Instagram post

Delete one of your own Instagram posts or reels by shortcode. Opens the post, drives More options then Delete and the confirmation, and then reloads the post's link to prove it is really gone before reporting success. Returns the shortcode, the media id when Instagram exposes it, and whether the post was verified as removed. Fails clearly when the shortcode is not available to you (already deleted, private, or another account's) and when the post is still live after the confirmation.

Start building not clicking

Get started for free