What it does
The official X API v2 offers post search (recent and full-archive), filtered streams, users, lists and more with Bearer or OAuth auth. Billing is pay-per-use per resource returned; rate limits are per 15-minute window (e.g. recent search 450/15min per app, 300/15min per user) with x-rate-limit-* headers.
In its API docs
Pricing
What X API publishes for buying direct, as listed on its own pages.
Buying direct from X API
- Posts: Read$0.005 per resource
- User: Read$0.010 per resource
- Post: Create$0.015 per request
Docs
X API's own pages, linked as published.
- API referencedocs.x.com/x-api/introduction
- OpenAPI specapi.x.com/2/openapi.json
- Pricingdocs.x.com/x-api/getting-started/pricing
- Rate limitsdocs.x.com/x-api/fundamentals/rate-limits
- Websitex.com
Its OpenAPI document: 195 operations and rate limits
| Method | Path | Summary | Params | Source |
|---|---|---|---|---|
| GET | /2/account | Get developer account | 0 | Spec |
| POST | /2/account | Ensure developer account | 0 | Spec |
| GET | /2/account_activity/subscriptions/count | Get Account Activity Subscription Count | 0 | Spec |
| GET | /2/account_activity/webhooks/{webhook_id}/subscriptions/all | Validate Account Activity Subscription | 1 | Spec |
| POST | /2/account_activity/webhooks/{webhook_id}/subscriptions/all | Create subscription | 1 | Spec |
| GET | /2/account_activity/webhooks/{webhook_id}/subscriptions/all/list | Get Account Activity Subscriptions | 1 | Spec |
| DELETE | /2/account_activity/webhooks/{webhook_id}/subscriptions/{user_id}/all | Delete subscription | 2 | Spec |
| GET | /2/activity/stream | Activity Stream | 3 | Spec |
| GET | /2/activity/subscriptions | Get X activity subscriptions | 2 | Spec |
| POST | /2/activity/subscriptions | Create X activity subscription | 0 | Spec |
| DELETE | /2/activity/subscriptions | Delete X activity subscriptions by IDs | 1 | Spec |
| PUT | /2/activity/subscriptions/{subscription_id} | Update X activity subscription | 1 | Spec |
| DELETE | /2/activity/subscriptions/{subscription_id} | Deletes X activity subscription | 1 | Spec |
| POST | /2/articles/draft | Create draft Article | 0 | Spec |
| POST | /2/articles/{article_id}/publish | Publish Article | 1 | Spec |
| GET | /2/bots | Get Bots | 0 | Spec |
| POST | /2/bots | Create a bot | 0 | Spec |
| PUT | /2/bots/{id} | Update Bot | 1 | Spec |
| DELETE | /2/bots/{id} | Delete Bot | 1 | Spec |
| POST | /2/bots/{id}/token | Rotate Bot Token | 1 | Spec |
| DELETE | /2/bots/{id}/token | Revoke Bot Token | 1 | Spec |
| GET | /2/broadcasts | List broadcasts | 3 | Spec |
| GET | /2/broadcasts/chat/moderators | Get chat moderators | 0 | Spec |
| POST | /2/broadcasts/chat/moderators | Add a chat moderator | 0 | Spec |
| DELETE | /2/broadcasts/chat/moderators/{user_id} | Remove a chat moderator | 1 | Spec |
| GET | /2/broadcasts/scheduled | List scheduled broadcasts | 4 | Spec |
| POST | /2/broadcasts/scheduled | Create a scheduled broadcast | 0 | Spec |
| GET | /2/broadcasts/scheduled/{id} | Get a scheduled broadcast | 1 | Spec |
| PUT | /2/broadcasts/scheduled/{id} | Update a scheduled broadcast | 1 | Spec |
| DELETE | /2/broadcasts/scheduled/{id} | Delete a scheduled broadcast | 2 | Spec |
| POST | /2/broadcasts/scheduled/{id}/live | Go live on a scheduled broadcast | 1 | Spec |
| GET | /2/broadcasts/{id} | Get a broadcast | 1 | Spec |
| GET | /2/broadcasts/{id}/chat | Get broadcast chat history | 3 | Spec |
| POST | /2/broadcasts/{id}/chat | Send a chat message to a live broadcast | 1 | Spec |
| POST | /2/broadcasts/{id}/chat/mutes | Mute or time out a user in a broadcast chat | 1 | Spec |
| DELETE | /2/broadcasts/{id}/chat/mutes/{user_id} | Unmute a user in a broadcast chat | 2 | Spec |
| DELETE | /2/broadcasts/{id}/chat/{message_id} | Remove a chat message from a live broadcast | 2 | Spec |
| GET | /2/chat/conversations | Get Chat Conversations | 2 | Spec |
| POST | /2/chat/conversations/group | Create Chat Group Conversation | 0 | Spec |
| POST | /2/chat/conversations/group/initialize | Initialize Chat Group | 0 | Spec |
Showing 40 of 195 operations; the full list is in the spec.
Rate limits
Per endpoint per 15 min, e.g. search/recent 450/15min app, 300/15min user Without a published limit GridRouter paces conservatively (1 call per second).
Sources for this page (4)
- X API introductionchecked Sep 29, 2026
- X API rate limitschecked Sep 29, 2026
- X API pricingchecked Sep 29, 2026
- X API OpenAPI specchecked Sep 29, 2026
