How billing works
| Concept | Description |
|---|---|
| Credit-based | Purchase credits upfront, deducted as you use the API |
| Per-request pricing | Different endpoints have different costs |
| Real-time tracking | Monitor usage in the Developer Console |
| No caps | Use as much as you need—no monthly limits |
Tracked endpoints
Posts retrieved from these endpoints count toward usage:| Category | Endpoints |
|---|---|
| Post lookup | GET /2/tweets |
| Search | Recent search, Full-archive search |
| Streaming | Filtered stream, Filtered stream webhooks |
| Timelines | User posts, User mentions |
| Engagement | Liked posts, Bookmarks |
| Lists | List posts |
| Spaces | Spaces lookup |
Deduplication
Daily deduplication: If the same post is returned from multiple queries within a day, it only counts once for billing.
- Retrieving the same post multiple times in one day = 1 charge
- Retrieving a post again the next day = 1 additional charge
- Different posts in the same request = each counts separately
Monitoring usage
Track your usage in the Developer Console:| Metric | Description |
|---|---|
| Total usage | Posts retrieved in the billing period |
| By endpoint | Breakdown by endpoint type |
| By app | Usage per developer app |
| Cost tracking | Real-time cost calculations |
| Credit balance | Remaining prepaid credits |
Managing costs
Set budgets
Configure spending limits in the Developer Console.
Monitor alerts
Get notified before hitting budget thresholds.
Use caching
Cache responses to avoid re-fetching the same posts.
Optimize queries
Use precise filters to retrieve only needed posts.
Pricing details
For current pricing per endpoint and operation, visit the Developer Console. Pricing may vary by:- Endpoint type (search vs. lookup vs. stream)
- Operation (read vs. write)
- Data scope (recent vs. full-archive)
Enterprise options
For high-volume needs with custom pricing:- Dedicated support
- Volume discounts
- Custom rate limits
- Complete data access
FAQs
What happens if I run out of credits?
What happens if I run out of credits?
API requests will fail until you purchase more credits. Set up balance alerts to avoid interruption.
Are there monthly minimums?
Are there monthly minimums?
No. Pay only for what you use. You can have months with zero usage and zero cost.
How is streaming billed?
How is streaming billed?
Each unique post delivered through filtered stream counts toward usage, subject to daily deduplication.
Do failed requests count?
Do failed requests count?
No. Only successful responses that return data are billed.