get_x_post

posts:writeuses credits

Read a post on X (Twitter) from its link (x.com or twitter.com) or id. Use this whenever you need what an X post says: X blocks fetching x.com pages directly. Returns the whole text (long posts included), the author (handle, name, followers, verified, bio), created time, likes, reposts, replies, quotes, bookmarks and views, links with their titles, hashtags, mentions, the conversation id, and the posts it replies to, quotes or reposts with their text.

Pass includeMedia: true to also get each photo, video and GIF: image URL, alt text, size and, for videos, the playable MP4 variants. Spends credits: X charges per post returned, so this costs half a credit for the post plus half a credit for each quoted or replied-to post; a post read in the last 24 hours is free. usage says what was charged.

For the rest of a thread or its replies, use get_x_thread.

Input

• poststringrequired

  The post's link on X, like https://x.com/name/status/1234567890, or its numeric id.

  min length 1 · max length 500

• includeMediaboolean

  Also return each photo, video and GIF: image URL, alt text, size, and for videos the playable MP4 variants. Off by default to keep the response short; it costs no extra credits.

  default false

Permission

Needs the posts:write scope: create drafts. It changes your workspace, so clients may ask you to confirm each call.

Example call

Your assistant sends this for you. It is shown so you can see the shape of a call, with placeholder values for the required fields.

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_x_post",
    "arguments": {
      "post": "string"
    }
  }
}

Same action over the REST API

The tool runs POST /v1/orgs/{orgId}/marketing/x-posts/read as the signed-in user, with the same validation, approval rules and limits. See it in the X posts API reference.