Twitter API restrictions
Twitter (X) API restrictions come in three kinds: rate limits on how fast you can call, tier limits on what your plan can reach, and policy limits on what you may do with the data. Each kind produces a different error.

The three kinds of limit
Rate limits cap requests in a time window and return a 429. Tier limits set which endpoints your plan can use and how much data it can pull, and they usually return a 403. Policy limits cover what you may store, share or automate. You hit those on review, not on a single request.
The figures change over time. For the current numbers, with dates, see the X API pricing calculator and is the X API free.
Planning around them
Cache what you reuse, page with cursors, spread scheduled jobs across the window and back off when you get a 429. See X rate limit exceeded. On a hosted API, each plan sets its own limits, and a call that can't run returns a retryable error and isn't charged.
A normal response, for comparison
A normal X search call and the response we recorded.
curl "https://api.chatterapi.com/v1/x/tweets/search?q=%22crm+recommendation%22" \
-H "Authorization: Bearer $CHATTERAPI_KEY"{
"data": [
{
"id": "2099495333231288346",
"text": "meta ads: how important is the “connect to your crm” recommendation?\n\nthis essentially will tell meta if the lead was good or bad (ie converted), any experience how how is actually helps?\n\nthis particular client doesn’t …",
"url": "https://x.com/HesomParhizkar/status/2099495333231288346",
"createdAt": "2026-09-14T13:47:48.000Z",
"lang": "en",
"likes": 2,
"retweets": 0,
"replies": 2,
"quotes": 0,
"views": 138,
"bookmarks": 0,
"isReply": false,
"inReplyToId": null,
"conversationId": "2099495333231288346",
"isRetweet": false,
"quotedTweetId": null,
"type": "tweet",
"isQuote": false,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "35363135",
"handle": "HesomParhizkar",
"name": "Hesom",
"bio": "Startup Founder/Executive, investor, nba fan",
"followers": 584,
"following": 2010,
"tweets": null,
"verified": false,
"blueVerified": true,
"canDm": true,
"protected": null,
"location": "Marietta, GA",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/1871033188081942528/comvGkRg_normal.jpg",
"createdAt": "2009-04-26T01:18:19.000Z",
"profileUrl": "https://x.com/HesomParhizkar",
"bannerUrl": "https://pbs.twimg.com/profile_banners/35363135/1787179410",
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": [],
"quotedTweet": null,
"retweetedTweet": null
},
{
"id": "2040879100261458222",
"text": "Here's a live audit on what happens when buyers ask AI for a CRM recommendation. You can't miss it...",
"url": "https://x.com/apoorvshrm/status/2040879100261458222",
"createdAt": "2026-04-05T19:47:49.000Z",
"lang": "en",
"likes": 4,
"retweets": 0,
"replies": 1,
"quotes": 0,
"views": 145,
"bookmarks": 0,
"isReply": false,
"inReplyToId": null,
"conversationId": "2040879100261458222",
"isRetweet": false,
"quotedTweetId": "2040878095415304308",
"type": "quote",
"isQuote": true,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "1459048370371137542",
"handle": "apoorvshrm",
"name": "Apoorv Sharma | SEO and GEO for B2B SaaS",
"bio": "SEO + GEO for B2B SaaS. I help SaaS brands rank on Google and get recommended by Claude, Gemini, and Google AI.\nCo-Founder, DerivateX",
"followers": 2316,
"following": 519,
"tweets": null,
"verified": false,
"blueVerified": true,
"canDm": true,
"protected": null,
"location": "Bengaluru",
"url": null,
"avatarUrl": "https://pbs.twimg.com/profile_images/2069124654112149504/AWTErF4d_normal.jpg",
"createdAt": "2021-11-12T06:40:23.000Z",
"profileUrl": "https://x.com/apoorvshrm",
"bannerUrl": "https://pbs.twimg.com/profile_banners/1459048370371137542/1770951885",
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": [],
"quotedTweet": {
"id": "2040878095415304308",
"text": "I just ran a live AI visibility audit on HubSpot.\n\nTyped the same prompt into ChatGPT, Perplexity, and Gemini.\n\nThe results were... WILD.\n\nHere's what I found 🧵",
"url": "https://x.com/apoorvshrm/status/2040878095415304308",
"createdAt": null,
"lang": null,
"likes": null,
"retweets": null,
"replies": null,
"quotes": null,
"views": null,
"bookmarks": null,
"isReply": false,
"inReplyToId": null,
"conversationId": null,
"isRetweet": false,
"quotedTweetId": null,
"type": "tweet",
"isQuote": false,
"isPinned": false,
"source": null,
"hasVideo": false,
"urls": [],
"mentions": [],
"author": {
"id": "",
"handle": "apoorvshrm",
"name": "Apoorv Sharma | SEO and GEO for B2B SaaS",
"bio": null,
"followers": null,
"following": null,
"tweets": null,
"verified": null,
"blueVerified": null,
"canDm": null,
"protected": null,
"location": null,
"url": null,
"avatarUrl": null,
"createdAt": null,
"profileUrl": "https://x.com/apoorvshrm",
"bannerUrl": null,
"likesGiven": null,
"mediaCount": null,
"pinnedTweetIds": null
},
"media": []
},
"retweetedTweet": null
}
],
"page": {
"nextCursor": "ATcD…",
"hasMore": true
}
}Recorded from a live call on . Long text is shortened and the cursor is cut. A live key is charged 2 credits for this call. A test key returns this same sample for 0 credits.
Free tools
Questions
What are the main Twitter API restrictions?
Why do I get a 403?
Are the numbers fixed?
Guides
- X API rate limit exceeded (429): every limit and how to stay under
- Twitter API cost in 2026: a calculator for X data workloads
- Twitter API free in 2026? What you can still read for $0