# XBeast Public API v1

> Schedule and publish your own tweets through XBeast — with auto-reply and auto-retweet — using a simple REST API.

Source: https://xbeast.io/docs/api

The XBeast Public API lets you **schedule and publish your own tweets** through a connected X (Twitter) account — including auto-reply and auto-retweet. You do not need XBeast AI generation. Bring text and media from your CMS, bot, or script.

> **Premium required**
>
> API keys and all /api/v1 endpoints are available on paid XBeast plans only.

## Base URL

```text
https://xbeast.io/api/v1
```

## What you can do

- [Schedule a tweet](https://xbeast.io/docs/api-posts.md) for a specific time, or post immediately
- Turn on auto-reply and auto-retweet for that post
- [Upload images or video](https://xbeast.io/docs/api-media.md) (or pass an HTTPS media URL)
- [List connected accounts](https://xbeast.io/docs/api-accounts.md) and [check remaining credits](https://xbeast.io/docs/api-credits.md)

## Quick start

1. Subscribe to a [**paid plan**](https://xbeast.io/premium).
2. Connect an X account from the [**dashboard**](https://xbeast.io/dashboard).
3. Create an API key on [**Developer API**](https://xbeast.io/developers). 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

**POST /api/v1/posts**

```bash
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](https://xbeast.io/docs/api-authentication.md) — Bearer API keys
- [Errors](https://xbeast.io/docs/api-errors.md) — status codes and payload
- [GET /accounts](https://xbeast.io/docs/api-accounts.md)
- [GET /credits](https://xbeast.io/docs/api-credits.md)
- [POST /media](https://xbeast.io/docs/api-media.md)
- [Posts](https://xbeast.io/docs/api-posts.md) — 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 8 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?

No. Connect your X account in XBeast. The API publishes through that connection.

#### Can I skip AI-generated posts?

Yes. This API is for bring-your-own content. Presets and AI generation stay in the XBeast app.

#### Where do I create a key?

In the app: [Developer API](https://xbeast.io/developers). The full secret is shown only once.

[Authentication](https://xbeast.io/docs/api-authentication.md)