XBeast Public API v1

Base URL

https://xbeast.io/api/v1

What you can do

• Schedule a tweet for a specific time, or post immediately
• Turn on auto-reply and auto-retweet for that post
• Upload images or video (or pass an HTTPS media URL)
• List connected accounts and check remaining credits

Quick start

1. Subscribe to a paid plan.
2. Connect an X account from the dashboard.
3. Create an API key on Developer API. Copy it once.
4. Call GET /api/v1/accounts to get an account_id.
5. Call POST /api/v1/posts with your tweet, scheduled_at, and optional auto-reply / auto-retweet.

Example: schedule a tweet at noon with auto-reply

curl -X POST "https://xbeast.io/api/v1/posts" \
  -H "Authorization: Bearer xb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "YOUR_ACCOUNT_ID",
    "tweets": [{ "text": "Hello from my own content pipeline." }],
    "scheduled_at": "2026-08-25T16:00:00.000Z",
    "auto_reply": { "enabled": true, "max": 10 },
    "auto_retweet": { "enabled": true, "after_hours": 8 }
  }'

Endpoints

• Authentication — Bearer API keys
• Errors — status codes and payload
• GET /accounts
• GET /credits
• POST /media
• Posts — create, list, get, update, cancel

Limits

• Up to 5 active API keys per user
• Publishing to X costs 1 credit per post, charged after a successful send. Posts that contain a URL cost 2 extra credits
• Up to 7 scheduled or posted tweets per connected account per day (account timezone)
• Scheduled posts are published by XBeast cron; they must fall in the posting window when due
• Auto-reply and auto-retweet require a paid plan (same as the app)

FAQ

Do I need my own X developer account?

Can I skip AI-generated posts?

Where do I create a key?