Subscription
Starter — $20/month
140,000 credits included ($0.00014/credit). 1 monitor included. Best for prototyping and low-volume integrations.
Pro — $99/month
770,000 credits included ($0.00013/credit). 1 monitor included. Best for production workloads and growing teams.
Business — $199/month
1,670,000 credits included ($0.00012/credit). 1 monitor included. Best for high-volume automation and enterprise use.
Monthly credit allowance
Every subscription includes a monthly credit allowance that resets each billing period.- All metered operations deduct from a single shared pool
- No separate buckets per operation type
- Unused credits do not carry over
- API calls are also subject to rate limits (separate from credit usage)
- At 100% usage, metered calls return
402 Payment Required(see error handling for recovery patterns) - Non-metered operations (monitors, webhooks, integrations, account) always work
402 response body
Per-operation costs
Each metered operation deducts credits from your shared pool. Per-credit cost depends on your plan — from 0.00015 (PAYG).| Endpoint | Unit | Credits |
|---|---|---|
| Bookmark folders | per call | 1 |
| Bookmarks | per result | 1 |
| Community join/leave | per call | 10 |
| Create tweet | per call | 10 |
| Delete tweet | per call | 10 |
| DM history | per result | 1 |
| Download media | per media item | 1 |
| Favoriters | per result | 1 |
| Follow | per call | 10 |
| Follow check | per call | 5 |
| Followers you know | per result | 1 |
| Get article | per call | 5 |
| Get tweet | per call | 1 |
| Get user | per call | 1 |
| Like | per call | 10 |
| Notifications | per result | 1 |
| Retweet | per call | 10 |
| Search tweets | per tweet returned | 1 |
| Send DM | per call | 10 |
| Timeline | per result | 1 |
| Trends | per call | 3 |
| Unfollow | per call | 10 |
| Unlike | per call | 10 |
| Unretweet | per call | 10 |
| Upload media | per call | 10 |
| User likes | per result | 1 |
| User media | per result | 1 |
| User tweets | per tweet returned | 1 |
| Verified followers | per result | 1 |
Extractions & draws
Extractions consume 1-10 credits per result depending on the extraction type:| Credit cost | Extraction types |
|---|---|
| 1 per result | Tweets, replies, quotes, mentions, posts, likes, media, search |
| 1 per result | Followers, following, favoriters, retweeters, community members, people search, list members, list followers, verified followers |
| 5 per result | Articles |
Free operations
The following do not consume any credits: monitors, webhooks, integrations, account status, radar, extraction/draw history, cost estimates, tweet composition (compose, refine, score), style cache management, drafts, support tickets, API key management, X account management, and credit top-ups (checkout and quick top-up).Extra usage
If you need more credits beyond the included monthly allowance, enable extra usage from the dashboard subscription page. When extra usage is enabled:- Metered calls continue beyond the included credit allowance instead of returning
402 - Overage is billed separately through Stripe
- A spending limit caps how much overage you can accumulate before the next invoice
Example: Starter tier (0.00015 = 29.00 (subject to spending limit).
Spending limits
Your spending limit starts at $5 and increases automatically as you pay overage invoices:| Tier | Spending Limit |
|---|---|
| 1 | $5 |
| 2 | $7 |
| 3 | $10 |
| 4 | $15 |
| 5 | $25 |
Pay-per-use (MPP)
32 X-API read-only endpoints accept Machine Payments Protocol payments. No subscription required — pay per call with Tempo (USDC).MPP per-call pricing
| Endpoint | Price | Intent |
|---|---|---|
GET /x/tweets/{id} | $0.00015 per call | charge |
GET /x/tweets/search | $0.00015 per tweet | session |
GET /x/users/{id} | $0.00015 per call | charge |
GET /x/followers/check | $0.00105 per call | charge |
GET /x/articles/{id} | $0.00105 per call | charge |
POST /x/media/download | $0.00015 per media item | session |
GET /x/users/{id}/tweets | $0.00015 per tweet | session |
GET /x/tweets/{id}/quotes | $0.00015 per tweet | session |
GET /x/tweets/{id}/replies | $0.00015 per tweet | session |
GET /x/tweets/{id}/retweeters | $0.00015 per user | session |
GET /x/tweets/{id}/favoriters | $0.00015 per user | session |
GET /x/tweets/{id}/thread | $0.00015 per tweet | session |
GET /x/users/{id}/likes | $0.00015 per tweet | session |
GET /x/users/{id}/media | $0.00015 per tweet | session |
GET /trends | $0.00045 per call | charge |
GET /x/trends | $0.00045 per call | charge |
GET /x/communities/{id}/info | $0.00015 per call | charge |
GET /x/communities/{id}/members | $0.00015 per user | session |
GET /x/communities/{id}/moderators | $0.00015 per user | session |
GET /x/communities/{id}/tweets | $0.00015 per tweet | session |
GET /x/communities/search | $0.00015 per community | session |
GET /x/communities/tweets | $0.00015 per tweet | session |
GET /x/lists/{id}/followers | $0.00015 per user | session |
GET /x/lists/{id}/members | $0.00015 per user | session |
GET /x/lists/{id}/tweets | $0.00015 per tweet | session |
GET /x/users/batch | $0.00015 per user | session |
GET /x/users/search | $0.00015 per user | session |
GET /x/users/{id}/followers | $0.00015 per user | session |
GET /x/users/{id}/followers-you-know | $0.00015 per user | session |
GET /x/users/{id}/following | $0.00015 per user | session |
GET /x/users/{id}/mentions | $0.00015 per tweet | session |
GET /x/users/{id}/verified-followers | $0.00015 per user | session |
With a subscription, you get a monthly allowance included in the base price — metered costs only apply after that allowance is consumed. With MPP, every call is billed individually with no monthly commitment.
MPP overview
Protocol details, eligible endpoints, and comparison with subscriptions.
MPP quickstart
Make your first pay-per-use API call.
Checking usage
CallGET /api/v1/account to see your current period usage:
usagePercent field shows how much of your monthly quota has been consumed (0-100). At 100%, metered calls are rejected.
FAQ
What happens when I run out of credits?
What happens when I run out of credits?
Metered calls return
402 Payment Required. Non-metered operations (monitors, webhooks, integrations, account) continue working. Enable extra usage from the dashboard to continue.Do unused credits carry over?
Do unused credits carry over?
No. Credits reset to zero each billing period.
How do I check my current usage?
How do I check my current usage?
Call
GET /api/v1/account — the usagePercent field shows consumption (0-100).Can I downgrade or cancel anytime?
Can I downgrade or cancel anytime?
Yes. Changes take effect at the end of the current billing period.
Can I top up credits without a checkout redirect?
Can I top up credits without a checkout redirect?
Yes. Use the quick top-up endpoint to instantly charge your saved payment method. If no card is on file, use the standard top-up endpoint which redirects to Stripe checkout.
Next steps
Get Account
Full account endpoint reference with response schema.
API Overview
Base URL, authentication, rate limits, and conventions.