API & Integrations

How to use the OpenTweet API

The OpenTweet API is a REST API that allows you to create, schedule, list, and manage tweets programmatically. It's designed for developers building automations, AI agents, custom integrations, and workflows that need to post to X/Twitter.

API base URL

https://opentweet.io/api/v1

Authentication

All API requests require an API key sent in the Authorization header:

Authorization: Bearer ot_your_api_key_here

API keys use the ot_ prefix and can be created from Settings → API Keys in the OpenTweet dashboard.

Key endpoints

POST /api/v1/posts — Create a new tweet (draft, scheduled, or publish immediately).
GET /api/v1/posts — List your tweets with status filters.
POST /api/v1/posts/batch-schedule — Schedule multiple drafts at once.
GET /api/v1/accounts — List connected X accounts.
Evergreen endpoints — Full CRUD for evergreen queue management.

Rate limits

API rate limits depend on your plan: Pro allows 60 requests per minute and 1,000 per day; Advanced allows 300 per minute and 10,000 per day; Agency allows 600 per minute and 30,000 per day.