Skip to content

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.

Run the tweet search now, no signupThen copy the Java example on this page.
Twitter API Java: a note travels along a rail past brass cogs and a cup.

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

  1. Set the key

    Export CHATTERAPI_KEY and read it with System.getenv. Don't hard code it in source.

  2. Build the request

    Create an HttpRequest for /v1/x/tweets/search with the query URL-encoded and the Authorization: Bearer header.

  3. Send and read the body

    Call client.send with a string body handler, check the status code, then pass the body to your JSON parser.

  4. Page forward

    Read page.nextCursor from the response and send it as cursor on the next request until page.hasMore is false.

Endpoints that do it

EndpointWhat it's forCredits
Search tweetsGET /v1/x/tweets/searchTweets by keyword, with X search operators.2 credits
List user tweetsGET /v1/x/users/{handle}/tweetsAn 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.

Search tweets with java.net.http.HttpClient (Java 11 or later).
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"
response, first 2 rows
{
  "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?
No. Java 11 and later include HttpClient, which is enough to call the API and read JSON.
Is there OAuth to set up?
No. A bearer key in the Authorization header authenticates every request.
Can I stream tweets in Java?
Not through this API. It returns pages when you ask for them, so call it on a schedule to pick up new tweets.
Does it work on older Java versions?
The example needs Java 11 or later. On Java 8, use whatever HTTP client you already have and send the same header.

Other languages

Build it with one API key

Try it free for 7 days with 1,000 credits.