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.
If you are on a legacy subscription package (Basic or Pro), you can opt in to Pay-per-use pricing directly from the Developer Console. If you’d like to switch back to your legacy plan at any time, you can do so from the settings page within 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.| Resource | Unit Cost |
|---|---|
| Posts: Read | $0.005 per resource |
| User: Read | $0.010 per resource |
| DM Event: Read | $0.010 per resource |
| Following/Followers: Read | $0.010 per resource |
| List: Read | $0.005 per resource |
| Space: Read | $0.005 per resource |
| Community: Read | $0.005 per resource |
| Note: Read | $0.005 per resource |
| Media: Read | $0.005 per resource |
| Analytics: Read | $0.005 per resource |
| Trend: Read | $0.010 per resource |
Write operations
Charged per request.| Action | Unit Cost |
|---|---|
| Content: Create | $0.015 per request |
| Content: Create (with URL) | $0.200 per request |
| DM Interaction: Create | $0.015 per request |
| User Interaction: Create | $0.015 per request |
| Interaction: Delete | $0.010 per request |
| Content: Manage | $0.005 per request |
| List: Create | $0.010 per request |
| List: Manage | $0.005 per request |
| Bookmark | $0.005 per request |
| Media Metadata | $0.005 per request |
| Privacy: Update | $0.010 per request |
| Mute: Delete | $0.005 per request |
| Counts: Recent | $0.005 per request |
| Counts: All | $0.010 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:
| Endpoint | Description |
|---|---|
GET /2/users/{id}/tweets | Your own posts |
GET /2/users/{id}/mentions | Your mentions |
GET /2/users/{id}/liked_tweets | Posts you liked |
GET /2/users/{id}/bookmarks | Your bookmarks |
GET /2/users/{id}/followers | Your followers |
GET /2/users/{id}/following | Accounts you follow |
GET /2/users/{id}/blocking | Accounts you blocked |
GET /2/users/{id}/muting | Accounts you muted |
GET /2/users/{id}/owned_lists | Lists you own |
GET /2/users/{id}/followed_lists | Lists you follow |
GET /2/users/{id}/list_memberships | Lists you belong to |
GET /2/users/{id}/pinned_lists | Your pinned lists |
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:| Setting | Description |
|---|---|
| Recharge amount | The amount to add when auto-recharge triggers (e.g., $25) |
| Trigger threshold | Auto-recharge activates when your balance falls below this amount (e.g., $5) |
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.| Option | Description |
|---|---|
| Spending limit | Set a specific dollar amount as your maximum spend per 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.| Cumulative spend | Rate |
|---|---|
| $0 – $199 | 0% |
| $200 – $499 | 10% |
| $500 – $999 | 15% |
| $1,000+ | 20% |
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:| Purchase | Rate | Total owed | Already credited | You receive |
|---|---|---|---|---|
| $100 | 0% | $0 | $0 | $0 |
| $100 | 10% | $20 | $0 | $20 |
| $150 | 10% | $35 | $20 | $15 |
| $150 | 15% | $75 | $35 | $40 |
| $250 | 15% | $112.50 | $75 | $37.50 |
| $250 | 20% | $200 | $112.50 | $87.50 |
| $1,000 | $200 |
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.