Solutions · Scheduling and publishing
Post and schedule on X from your own tool
For scheduling and publishing tools, and agencies that run their own or their clients' accounts: post with images and video, schedule posts, keep drafts, reply, quote and run polls. Every action is one call, the same price as a read: $0.065 to $0.10 per 1,000.
Each request carries the account's X session (cookie) and a proxy. X session guide
What you can do
Everything a publishing tool needs
Each line is one endpoint and one call.
Upload a video
/client/media/video
Waits for X to process it; check a media ID later with /client/media/statusSchedule a post
/client/create + schedule_time
List with /client/schedule-overview, cancel with /client/schedule-deleteRun a poll
/client/create + poll
2 to 4 choices, 5 minutes to 7 daysQuote a post
/client/create + quote_url
Your comment above the quoted postPost into a community
/client/create + community_id
Posts into that community
Who can reply (conversation_control_mode) and the sensitive-media flag are options of the same calls.
How it works
One request per action
Every account action is a POST with a JSON body. Next to the action's own fields it carries the account's session cookie (auth_token and ct0) and the proxy the request to X goes out through. The session goes with each request, so one API key can work for many accounts.
- Keep the same proxy for the same account, in the region it usually logs in from.
- If someone logs out of that session, the cookie stops working; ask for a fresh one.
- With
format=simplea new post comes back as the same Tweet object the read endpoints return.
Use your own account or one you're authorised to manage, and follow X's rules on automation.
Cost
What publishing costs
A post with one image is two calls: the upload and the post. Account actions cost the same per call as reads. Calls that fail with 400, 408, 409 or a 5xx error are refunded.
One brand, 2 posts a day with an image
$0.01per month at Standard
- Calls per month
- 120
- At Scale
- $0.0096
Agency: 25 accounts, 2 posts a day each
$0.30per month at Standard
- Calls per month
- 3,000
- At Scale
- $0.24
Tool with 500 accounts, 3 posts a day each
$9.00per month at Standard
- Calls per month
- 90,000
- At Scale
- $7.20
30-day month. New accounts get $0.50 free credit. Pricing
FAQ
Scheduling and publishing questions
Does X keep the scheduled post, or do I have to send it at the right time?
X keeps it. /client/create with schedule_time stores the post on the account's own schedule, the same one x.com uses, and X publishes it. You can list and cancel scheduled posts by API. Scheduled posts take text and media; polls, quotes and community posts are posted right away.
How do I post a thread?
Post the first tweet, then reply to it with the next part, then reply to that reply, and so on. Each part is one call.
Can I manage client accounts?
Yes, with each client's consent: every request carries the session cookie of the account it acts on, plus a proxy. Keep one proxy per account and store each client's cookie like a password.
Which images and videos work?
Images: JPEG, PNG or WebP up to 5 MB, GIF up to 15 MB. Videos: MP4 or MOV; the request body is limited to 100 MB, so about 75 MB of video. Files X would refuse get a 400 before anything is sent to X, and that call is refunded.
Do I need an X developer account?
No. You need a TwittrAPI key, the X session (cookie) of the account and a proxy. The X session guide shows how to copy the cookie.
Related
Read next
- Account actions →Every endpoint, with parameters and errors/docs/account-actions
- X session guide →Cookie and proxy/docs/x-session
- Post a tweet →Media, polls, quotes, schedule_time/docs/account-actions/client-create
- AI agents that post →Drafts by an agent, posted after you approve/use-cases/agents-that-post
- Social listening →See how posts land/use-cases/social-listening
Publish your first post by API
Get a key, copy your X session, and post. New accounts start with $0.50 free credit.