App Logo
x.com

Get X DM inbox

List the state of every DM conversation in your X inbox. Returns per conversation: conversation_id, name, handle, last_message, time, sent_by_me, unread. If X shows the Enter Passcode screen, pass the 4-digit E2E pin.

Input

pin optional

4-digit E2E passcode — required only if X shows the Enter Passcode screen. Omit otherwise.

Output

conversations required

One entry per conversation in the inbox, in the order X lists them. Empty when the inbox has no conversations.

FAQ

List the state of every DM conversation in your X inbox. Returns per conversation: conversation_id, name, handle, last_message, time, sent_by_me, unread. If X shows the Enter Passcode screen, pass the 4-digit E2E pin.
Optional: pin.
It returns conversations.
Yes. It acts as you on x.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the x.com cookies saved by the Reduck extension.
It only reads. It looks things up on x.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/x.com/get_inbox, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/x.com/get_inbox
It is part of Reduck's official curated catalogue.

Related scripts

x.com

Search X tweets

Search X for tweets, supporting all X search operators; the tab arg picks 'top' (ranked sample, default) or 'latest' (chronological). Returns per tweet a canonical record: id, url, author {id, handle, name}, text, created_at, lang, likes, retweets, replies, quotes, bookmarks, views, is_retweet, is_quote, plus followers (the author's follower count, a search-only enrichment), and the top-level query and count. Top is a ranked sample, not exhaustive.

x.com

Delete tweet

Delete one of your own tweets given its URL. Returns the deleted tweet id and a deleted flag.

x.com

Get X user posts

Get a user's Posts tab by handle (x.com/<handle>) — their own tweets and self-threads, newest first. Excludes replies to others (see get_user_replies for the Replies tab), and excludes reposts, which X keeps on a separate Reposts tab. The post count shown on the profile header includes replies, so expect fewer items than that number. Returns per tweet: id, url, text, created_at, lang, likes, retweets, replies, quotes, views, bookmarks, is_retweet, is_quote. Count is capped by how far X paginates before throttling.

Start building not clicking

Get started for free