List replies
Tool ID: x_reply_list
Summary
Lists replies in one conversation. Read-only. By default this is the last 7 days of replies, newest first.
When to use it
- You want the comments under a post before you reply.
- You want to see who answered an Article (comments are replies on the seed post).
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| X account connected by an administrator | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
conversation_id |
One of these | Usually the original post’s id. |
post_id |
One of these | Any post in the thread. The tool looks up the conversation. |
url |
One of these | A status link in the thread. |
max_results |
No | How many replies. Default 10. The API minimum is 10 and the maximum is 100. |
pagination_token |
No | next_token from the previous page. |
sort |
No | newest (default) or oldest. Oldest only flips the current page. |
archive |
No | When true, search the full history if the account’s API access allows it. |
What you get back
The conversation id, the replies (same shape as Get post), and next_token when another page exists.
Example prompts
Show me the latest replies on https://x.com/example/status/123
List replies on that thread from the start of the page, oldest first.
Tips
- A busy thread may need another request with the returned
next_token. - Replies older than about 7 days need the full archive (
archive), which depends on the API plan.