App Logo
tiktok.com

Get TikTok direct message inbox

List the signed-in account's direct message conversations, newest activity first: who each one is with, the last message preview as the inbox shows it, and the timestamp label. Handles and nicknames are resolved for every participant, so a conversation can be read afterwards with the get-conversation script. This is the private messages list, not the activity feed of likes and follows — use the notifications script for those.

Input

count optional

Target number of conversations to collect; the inbox list is scrolled until this many are gathered or it ends.

Default: 30

Output

hasMore required

True when the inbox still had conversations beyond the ones returned.

account_used required

Handle whose inbox was read, from the signed-in session.

conversations required

FAQ

List the signed-in account's direct message conversations, newest activity first: who each one is with, the last message preview as the inbox shows it, and the timestamp label. Handles and nicknames are resolved for every participant, so a conversation can be read afterwards with the get-conversation script. This is the private messages list, not the activity feed of likes and follows — use the notifications script for those.
Optional: count.
It returns hasMore, account_used, conversations.
Yes. It acts as you on tiktok.com: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the tiktok.com cookies saved by the Reduck extension.
It only reads. It looks things up on tiktok.com and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/tiktok.com/get_inbox, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/tiktok.com/get_inbox
It is part of Reduck's official curated catalogue.

Related scripts

tiktok.com

Get TikTok following

List who a TikTok user follows, by @username. Accounts that keep their following list hidden, and private accounts, are reported with a clear reason instead of an empty or partial list; a handle nobody owns is reported as such. For third-party accounts, TikTok caps the list and pads short ones with suggested accounts, so check `total` and `truncated`; results are only fully reliable for accounts you can see in full, such as your own.

tiktok.com

Search TikTok users

Search TikTok accounts by keyword. Returns the top ~10 matches (TikTok web caps user search; not deeply paginable).

tiktok.com

Get TikTok profile

Get a TikTok user's profile (bio, stats, verified, secUid) by @username.

Start building not clicking

Get started for free