Read an X conversation
x_threadResolve a post URL or status ID to its conversation and retrieve posts from that thread, with recent or full scope options and pagination for read-only thread analysis.
Instructions
Resolve a post's conversation_id and read posts in that conversation. Recent scope only covers the last 7 days; full scope may be forbidden. Read-only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"post": "<post>"
},
"name": "x_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| post | Yes | Any post URL or numeric status ID in the conversation. | |
| scope | No | recent | |
| expansions | No | X API expansions, for example author_id,attachments.media_keys,referenced_posts. | |
| max_results | No | Recent search accepts 10-100; full-archive search accepts 10-500. | |
| poll_fields | No | Mapped to poll.fields. | |
| post_fields | No | Mapped to the current query parameter post.fields. | |
| user_fields | No | Mapped to user.fields. | |
| media_fields | No | Mapped to media.fields. | |
| place_fields | No | Mapped to place.fields. | |
| pagination_token | No | Opaque next_token from a previous thread page. |