Skip to content
a java library which scrapes twitter to fetch publicly available info
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
gradle/wrapper init May 31, 2019
src fixed issue #4 Jan 16, 2020
.gitignore remove logging Aug 27, 2019
LICENSE added license and readme Sep 6, 2019 added badges to README Jan 18, 2020
build.gradle remove logging Aug 27, 2019
settings.gradle init May 31, 2019


MIT license GitHub release

This is a Java library which lets you fetch Twitter public data without the need to use any API.


  • The JAR file for this entire library is just 430 KB.
  • Unlike the official Twitter API, TwitterScraper4J doesn't have any rate limits.
  • Unlike the official Twitter API, TwitterScraper4J doesn't require any generation of Tokens, Keys etc. It's just a plug and play library.
  • Can fetch around 3200 (or sometimes more) tweets for any public account.
  • Get basic profile information.
  • Search for users.
  • Search for tweets (with keywords, hashtags etc.).
  • Get all followers list
  • Get all following list
  • Streaming tweets (this is not as good as the official Twitter API and is still experimental)


  • Cannot get the number of likes and retweets.
  • Cannot get all the replies for a tweet.
  • Cannot download videos attached to tweets.
  • If multiple images are attached to a tweet, then this library can fetch only the first image.

Getting Started

JAR file is available in the release section. Download the JAR file, add it to your Java project and start using it!

For Gradle projects, a better way of adding this library as a dependency is,

Add the following in your root build.gradle:

allprojects {
	repositories {
		maven { url '' }

Next, add the dependency:

dependencies {
        implementation 'com.github.NandanDesai:TwitterScraper4J:v1.2.1-beta'

Code Examples

  • Getting Profile information like name, description, location, number of followers, verified status, profile picture etc.

    TwitterScraper scraper = TwitterScraper.builder().build();  
    Profile profile = scraper.getProfile("realDonaldTrump");
  • Getting the user's timeline

    TwitterScraper twitterScraper = TwitterScraper.builder().build();  
    List<Tweet> tweets=twitterScraper.getUserTimeline("realDonaldTrump");  
    for(Tweet tweet:tweets){  
  • Search a user

    TwitterScraper scraper = TwitterScraper.builder().build();  
    List<User> users =scraper.searchUser("Narendra Modi");  
    for (User result: users){  
  • Get worldwide trends

    TwitterScraper scraper=TwitterScraper.builder().build();  
  • Get all followers list

    TwitterScraper twitterScraper = TwitterScraper.builder().build();
    Iterator<List<User>> it=twitterScraper.getAllFollowers("realDonaldTrump");
        for(User user:users){
  • Fetch around 3200 tweets for a given profile

    TwitterScraper twitterScraper = TwitterScraper.builder().build();
    Iterator<List<Tweet>> it=twitterScraper.getAllTweets("realDonaldTrump");
        for(Tweet tweet:tweets){
  • Get a stream of tweets for a particular keyword or hashtag (EXPERIMENTAL feature)

     TwitterScraper twitterScraper = TwitterScraper.builder().build();
     TweetStream stream=twitterScraper.getTweetStream("Kashmir");
     stream.setStreamListener(new TweetStreamListener() {
         public void onPageRefresh(List<Tweet> tweets) {
             for(Tweet tweet:tweets){
  • To use a proxy

    Proxy proxy = new Proxy(Proxy.Type.SOCKS, new InetSocketAddress(<ip address>, <port>));
    TwitterScraper twitterScraper = TwitterScraper.builder().proxy(proxy).build();

There is a lot more this library can offer. Refer tests for other examples.

To-do List

  • Getting media links
  • Complete 'retweet with comment'
  • Timestamps
  • Add proxy support
  • Getting a stream of tweets containing a given keyword (EXPERIMENTAL)
  • Followers of a given user
  • Friends of a given user



You can’t perform that action at this time.