How it works
Credit-based
Purchase credits upfront in the Developer Console. Credits are deducted as you make API requests.
Per-endpoint pricing
Different endpoints have different costs. View current rates in the Developer Console.
No commitments
No contracts, subscriptions, or minimum spend. Start and stop anytime.
Real-time tracking
Monitor usage and costs live in the Developer Console.
Credit consumption details
All prices are per resource fetched (reads) or per request (writes/actions). Purchase credits in the Developer Console.Read operations
Charged per resource returned in the response.Write operations
Charged per request.Prices are subject to change. Current rates are always available in the Developer Console and on the developer.x.com pricing page.
Owned Reads
Owned Reads are requests made by your own developer app for your own data (posts, bookmarks, followers, likes, lists, and more). These endpoints are priced at $0.001 per resource (1,000 resources for $1). The following endpoints qualify for Owned Read pricing when{id} matches the authenticated user and that user is the owner of the developer app:
Deduplication
All resources are deduplicated within a 24-hour UTC day window. If you request and are charged for a resource (such as a Post), requesting the same resource again within that window will not incur an additional charge. This means:- Requesting the same Post multiple times in a day counts as one charge
- The deduplication window resets at midnight UTC
- This applies to all billable resources (Posts, users, etc.)
Deduplication is a soft guarantee. While it occurs in the vast majority of cases, there may be specific edge cases like service outages that result in resources not being deduplicated.
Credit balance
Your credit balance is displayed in the Developer Console. Credits are deducted in real-time as you make API requests.Auto-recharge
Enable auto-recharge to automatically top up your credit balance and avoid service interruptions. Configure this in the Developer Console:Auto-recharge requires a saved payment method set as your default. You can cancel anytime in the Developer Console or by contacting support.
Spending limits
Set a maximum amount you can spend per billing cycle to control costs. When the limit is reached, API requests will be blocked until the next billing cycle.Free xAI API credits
When you purchase X API credits, you can earn free xAI API credits based on your cumulative spend during a billing cycle.To receive free xAI credits, you must link your xAI team to your X developer account. You can do this by visiting your account settings in the developer console.
How it works
Your cumulative spend is tracked throughout each billing cycle. As you cross spending thresholds, you unlock higher reward rates. When a new billing cycle starts, your cumulative spend resets to $0.The rate applies to your entire cumulative balance, but you only receive the delta—what’s newly owed minus what was already credited.
Example
Suppose you make several purchases throughout a billing cycle:
This is the same amount you’d receive from a single $1,000 purchase—the order and size of purchases doesn’t affect your total rewards.
Monitoring usage
Track your API usage programmatically with the Usage endpoint:- Track consumption against your budget
- Set up alerts when approaching limits
- Identify high-consumption endpoints
- Generate usage reports
Next steps
Developer Console
Purchase credits and view current pricing.
Usage API
Monitor usage programmatically.