Twitter API Java example: search tweets
This Twitter API Java tutorial uses the java.net.http.HttpClient that ships with Java 11 and later. You send a GET request with a bearer key and read the JSON response. You don't need an SDK or any OAuth setup. The example searches tweets. It doesn't stream, because the API is pull based.

The job
Most Twitter API Java examples start with an OAuth library and a developer app. To read public tweets you can skip both: build a request, add an Authorization header and read the body.
The code below searches for a keyword and prints the raw JSON. In a real project, parse it with Jackson or Gson into a class that holds the fields you use, such as text, createdAt and likes.
The API returns pages with a cursor, and you get the next page by sending cursor back. There is no push stream. If you need new tweets, call again on a schedule.
How it works
Set the key
Export
CHATTERAPI_KEYand read it withSystem.getenv. Don't hard code it in source.Build the request
Create an
HttpRequestfor/v1/x/tweets/searchwith the query URL-encoded and theAuthorization: Bearerheader.Send and read the body
Call
client.sendwith a string body handler, check the status code, then pass the body to your JSON parser.Page forward
Read
page.nextCursorfrom the response and send it ascursoron the next request untilpage.hasMoreis false.
Endpoints that do it
| Endpoint | What it's for | Credits |
|---|---|---|
| Search tweetsGET /v1/x/tweets/search | Tweets by keyword, with X search operators. | 2 credits |
| List user tweetsGET /v1/x/users/{handle}/tweets | An account's recent tweets. | 2 credits |
| Get a userGET /v1/x/users/{handle} | A profile by handle. | 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.
The response your Java code receives
The request is in the code above. The response shown was recorded from a real search.
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class SearchTweets {
public static void main(String[] args) throws Exception {
String key = System.getenv("CHATTERAPI_KEY");
String q = URLEncoder.encode("java lang:en", StandardCharsets.UTF_8);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.chatterapi.com/v1/x/tweets/search?q=" + q + "&sort=latest"))
.header("Authorization", "Bearer " + key)
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
if (response.statusCode() != 200) {
throw new RuntimeException("Request failed: " + response.statusCode() + " " + response.body());
}
System.out.println(response.body());
}
}
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
- Public tweets only. Protected accounts and deleted tweets are not returned.
- The API is pull based. There is no streaming connection, so poll for new tweets.
- Keep the key out of source control and out of client-side code.
- The example prints raw JSON. Add a JSON library to turn it into objects.
Questions
Do I need an SDK for the Twitter API in Java?
HttpClient, which is enough to call the API and read JSON.Is there OAuth to set up?
Authorization header authenticates every request.