X posting API
yeetpost posts to X with one HTTP call: POST the text to /api/v2/post/x with an API key. X charges for write access, so yeetpost bills a flat per-post fee at X's own cost: 1.5 cents a post, 20 cents when the post has a link.
Post with curl
curl -X POST https://api.yeetpost.com/api/v2/post/x \
-H "x-api-key: $YEETPOST_API_KEY" \
-d 'v2.4 is live. changelog: https://example.com/changelog'The body is the post. The slug in the path is your connection's slug; GET /api/v2/connections lists yours. For several connections, scheduling, drafts and idempotency use POST /api/v2/posts, see the posting guide.
Post from an agent over MCP
claude mcp add --transport http \
--header 'Authorization: Bearer ${YEETPOST_API_KEY}' \
yeetpost https://api.yeetpost.com/api/v2/mcp
# then ask Claude: post this to my X accountThe hosted MCP server also accepts an OAuth login, so claude.ai can add it as a custom connector with no key. See MCP for agents.
X limits
| Text | 280 characters, advisory: a longer post is not refused by yeetpost and X decides |
|---|---|
| Images | Up to 4 per post, 5 MB each |
| Threads | Yes, up to 24 replies under the head post |
| First comment | No |
| Delete | Yes |
| Metrics read back | Yes, billed 1 cent per read and off by default |
The text limit is advisory: yeetpost reports it as textLimit on GET /api/v2/connections but does not refuse a longer post, and X decides.
Connecting X
Authenticate with X in the yeetpost dashboard. X connections made before image posting shipped need reconnecting once before the first image.
Fees
1.5 cents per X post, 20 cents when the post has a link, passed through at X's own cost with no margin. X posting needs a payment method from the first post (402 payment_method_required without one). Plus the per-account price: the first 2 accounts free.
Posts are unlimited on every plan. See pricing.
Docs
Last verified 2026-10-29