Twitter API for academic research
Researchers use the X endpoints to collect posts for a defined query, note the date and parameters of each run, and export the results as JSON or CSV. Because the calls are repeatable, another person can rerun your method.

The job
A methods section needs a query, a date range and a collection date. Each call here takes those as plain parameters and returns posts with ids, authors, times and engagement counts. That lets you document the run line by line.
The same key also reads Reddit, which is useful when a study compares how a topic is discussed on two platforms. The academic research use case covers the Reddit side.
How it works
Fix the query first
Write down the search terms, language and time window before you collect anything. If you change them, start a new, dated run.
Collect and log
Call
x.searchand store the raw JSON with the date. Page through results with the cursor until you reach your sample size.Export for analysis
Load the JSON into pandas or R, or use the free exporters to get a CSV.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Search tweetsGET /v1/x/tweets/search | The main collection call, with time and language filters. | 2 credits |
| List repliesGET /v1/x/tweets/{id}/replies | Replies to a post, for thread studies. | 2 credits |
| Get a tweetGET /v1/x/tweets/{id} | One post with full detail, for a citation record. | 2 credits |
Free tools for the same job
Try the job in a browser first. These tools call the same endpoints, and you don't need a key or any code.
A dated keyword search
One search call. Save this raw response with the date as your collection record.
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.
What it won't do
- Results reflect what X returns on the day of the call, so save the date with each run. We don't promise a complete archive of every post.
- Deleted posts and protected accounts are not returned.
- Your institution decides whether collecting posts needs ethics review, so ask before you start.