List the replies to an X post

POST/v1/tools/x.post.replies/callsNeeds an API key

Returns the replies under an X post, by relevance, latest or likes, with author and engagement counts. Use it to read how people react to a post.

Tool x.post.replies on X (Twitter). Contract version 1, released 2026-11-01.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

post_idstringRequired

X's identifier of the post, the number after /status/ in its address.

Matches ^[0-9]+$.

sortstring· default relevance

Order of the replies: relevance (X's ranking), latest or likes.

relevance

latest

likes

next_page_tokenstring

Fetches the next page. Take it from pagination.next_page_token of the previous page, and send the same post_id and sort.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`replies`

A list of rows. Always present, possibly empty. The posts of the conversation under the post, which can include the author's own thread. The post itself is not included.

idstringRequired

X's identifier of the post. The post is at https://x.com/i/status/ followed by it.

urlstring

Address of the post on x.com.

Format uri.

textstring

What the post says, links written as X's t.co short links.

published_atstring

When the post was published, in ISO 8601.

author_idstring

X's numeric identifier of the author, as a string.

author_usernamestring

The author's handle, without the @.

author_namestring

The author's display name.

author_image_urlstring

Address of the author's profile picture.

author_follower_countinteger

reply_countinteger

repost_countinteger

quote_countinteger

like_countinteger

bookmark_countinteger

view_countinteger

Number of times the post was seen.

conversation_idstring

Identifier of the post that opened the thread.

in_reply_to_post_idstring

Identifier of the post this one replies to.

in_reply_to_usernamestring

Handle of the author this post replies to, without the @.

hashtagsarray of string

Each hashtag in the text, without the

mentioned_usernamesarray of string

Handle of each account the text mentions, without the @.

link_urlsarray of string

Full address of each link in the text.

image_urlsarray of string

Address of each photo attached to the post.

videosarray of object

Each video attached to the post.

videos.preview_image_urlstringRequired

Address of the video's still image.

videos.duration_msinteger

Length of the video, in milliseconds.

videos.widthinteger

Width of the original video, in pixels.

videos.heightinteger

Height of the original video, in pixels.

`pagination`

One object. Can be null. How to fetch the next page. Null on the last page.

next_page_tokenstringRequired

Send as next_page_token to fetch the next page.

curl https://api.voxoria.ai/v1/tools/x.post.replies/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"post_id":"2114780711664398349"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/x.post.replies/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"post_id": "2114780711664398349"}},
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/x.post.replies/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"input": {"post_id": "2114780711664398349"}}),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "x.post.replies",
    "input": {
      "post_id": "2114780711664398349"
    }
  }
}

200 OKoutputapplication/json

{
  "replies": [
    {
      "id": "2114780715086754261",
      "url": null,
      "text": "GPT-6.1 Terra continues to advance the cost-intelligence frontier across our model families.\n\nIt’s a significant step up over GPT‑5.6 Terra, with 50% lower standard API prices.\n\nIn ChatGPT Work and Codex, your usage allowance goes further with GPT‑6.1 Terra than with GPT‑5.6 Terra—and far more than with GPT‑6.1 Sol or GPT‑6 Astra.\n\nFor in-depth research or complex coding, choose GPT-6.1 Sol or GPT-6 Astra.",
      "published_at": "2026-10-26T18:06:27Z",
      "author_id": "4398626122",
      "author_username": "OpenAI",
      "author_name": "OpenAI",
      "author_image_url": "https://pbs.twimg.com/profile_images/1885410181409820672/ztsaR0JW_normal.jpg",
      "author_follower_count": null,
      "reply_count": 75,
      "repost_count": 146,
      "quote_count": 82,
      "like_count": 4308,
      "bookmark_count": 361,
      "view_count": 478753,
      "conversation_id": "2114780711664398349",
      "in_reply_to_post_id": null,
      "in_reply_to_username": null,
      "hashtags": null,
      "mentioned_usernames": null,
      "link_urls": null,
      "image_urls": null,
      "videos": [
        {
          "preview_image_url": "https://pbs.twimg.com/amplify_video_thumb/2114778628261072896/img/e4ev9yWyOgW8C4Mz.jpg",
          "duration_ms": 120000,
          "width": 1920,
          "height": 1080
        }
      ]
    },
    {
      "id": "2114780717188272382",
      "url": null,
      "text": "GPT-6.1 Terra substantially outperforms GPT-5.6 Terra on Agents’ Last Exam, a test of how well agents use software at work.\n\nIt even matches GPT-6 Astra at one-tenth the price per token and finishes tasks over 3× faster on average than both Astra and GPT-6.1 Sol. https://t.co/pzAmnvjBUi",
      "published_at": "2026-10-26T18:06:28Z",
      "author_id": "4398626122",
      "author_username": "OpenAI",
      "author_name": "OpenAI",
      "author_image_url": "https://pbs.twimg.com/profile_images/1885410181409820672/ztsaR0JW_normal.jpg",
      "author_follower_count": null,
      "reply_count": 133,
      "repost_count": 380,
      "quote_count": 496,
      "like_count": 3378,
      "bookmark_count": 564,
      "view_count": 1132831,
      "conversation_id": "2114780711664398349",
      "in_reply_to_post_id": null,
      "in_reply_to_username": null,
      "hashtags": null,
      "mentioned_usernames": null,
      "link_urls": null,
      "image_urls": [
        "https://pbs.twimg.com/media/HVk0CqWXkAAnsvd.png"
      ],
      "videos": null
    },
    {
      "id": "2114780720170164735",
      "url": null,
      "text": "GPT-6.1 Terra is rolling out now and is available to all Plus, Pro, Enterprise, and Edu users in ChatGPT Work and Codex.\n\nDevelopers can also access it through the OpenAI API as gpt-6.1-terra.\n\nhttps://t.co/TVsi7lEeX9",
      "published_at": "2026-10-26T18:06:29Z",
      "author_id": "4398626122",
      "author_username": "OpenAI",
      "author_name": "OpenAI",
      "author_image_url": "https://pbs.twimg.com/profile_images/1885410181409820672/ztsaR0JW_normal.jpg",
      "author_follower_count": null,
      "reply_count": 41,
      "repost_count": 73,
      "quote_count": 40,
      "like_count": 1528,
      "bookmark_count": 99,
      "view_count": 280169,
      "conversation_id": "2114780711664398349",
      "in_reply_to_post_id": null,
      "in_reply_to_username": null,
      "hashtags": null,
      "mentioned_usernames": null,
      "link_urls": [
        "https://openai.com/index/introducing-gpt-6-1-terra/"
      ],
      "image_urls": null,
      "videos": null
    }
  ],
  "pagination": {
    "next_page_token": "pt1.dGlraHViOkRBQUtDZ0FCSFdCZXZ3WF9fbmNMQUFJQUFBR29SVzFRUXpaM1FVRkJabEV2WjBkS1RqQjJSM0F2UVVGQlFVTlZaRmRVYTNWWVZuQkNhM2d4WVU5S1lrNXNNRU5WU0Zack1sZHNVbUZKUzI5a1YxUmtaVkpLWlhoNVFqRmFUekl6TkVacVJFbElWbXMwTUdacVltOVhSV1JYVkZscWRIaGhRbFZTTVZwUmFtcFJWMjVEUjBoV2F6TklXV1pZWTFSclpGZFViak5CU25CU2JIZ3hZV2hLVXpFeGFVZFhTRlpyTjBWWmRXRTBSRVZrVjFSaE1uWmtjVUp5UWpGYVVFSkdkRVl3UmtsSVZtc3pSa2RuWVdOWFkyUlhWRmhoVTBweGQwUlNNVnBPWkhoRWJHMUlMMGhXYkVSM2IxRmhWVkpqWkZkVmN6QjRlSEpTTkZJeFlVTmlWbk14ZFVGMFNGWnJOblY0Y1dFd1ZtZGtWMVJuVFRaV2NtaGpRakZhVDBKWGNsWnBSaXRJVm1zdlYxWkVXR05DTkdSWFZqbFBlbWhqUW5SNE1WcE9NblpGVm1sSFJVaFdiRUpWU2xOWVdWYzBaRmRVV1RWblduVm5jMEl4V2xCUGQyZ3lkRWRXU0Zac1NtVm5hV0pGVDFsa1YxUllZa1pLWlhneFVqRmFUemhuV0Zac1JWbElWbTE0YzFKMllVVkRUV1JYWmk5SFVVWm1VWFY0TVZwT1pIVlNNbXhFSzBoV2F6TjNWMGhYTkdOWlpGZFVZMFJrVm5OM2RsRTlQUWdBQXdBQUFBSUxBQVFBQUFBR1FtOTBkRzl0QUFB"
  }
}

The output of a real call, each list cut to 3 items.