App Logo
tiktok.com

Read a TikTok direct message conversation

Read the messages in one of the signed-in account's direct message threads, addressed either by the other person's @username or by the conversation id the inbox script returns. Messages come back oldest to newest with the timestamp labels TikTok shows between them, and system notices in the thread (such as a message request being accepted) are marked as notices rather than passed off as messages. Opening a thread marks it as read, which is what the site does too. Pairs with the inbox script, which lists the threads.

Input

count optional

Target number of messages to collect; the thread is scrolled back until this many are loaded or it reaches the beginning.

Default: 50
username optional

Handle of the person whose thread to read, with or without a leading @. Give this or conversationId.

conversationId optional

Conversation id as returned by the inbox script. Give this or username; it also addresses group threads, which have no single handle.

Output

hasMore required

True when older messages were still loading beyond the ones returned.

messages required

Oldest first, in the order the thread renders them.

account_used required
conversationId required
nickname optional

Display name shown at the top of the thread.

username optional

Handle shown at the top of the thread, without the @.

participants optional

Start building not clicking