elibus/j-google-trends-api

Java based implementation of Unofficial Google Trends API

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.elibus:j-google-trends-api:j-google-trends-api-1.5-6'
	}

	dependencies {
		implementation("com.github.elibus:j-google-trends-api:j-google-trends-api-1.5-6")
	}

	<dependency>
	    <groupId>com.github.elibus</groupId>
	    <artifactId>j-google-trends-api</artifactId>
	    <version>j-google-trends-api-1.5-6</version>
	</dependency>


                            
    libraryDependencies += "com.github.elibus" % "j-google-trends-api" % "j-google-trends-api-1.5-6"


                            
    :dependencies [[com.github.elibus/j-google-trends-api "j-google-trends-api-1.5-6"]]

Readme

Java Google Trends API (unofficial)

j-google-trends-api is a Java based implementation of Unofficial Google Trends API.

Google does not provide any API for its Trends services, this an unofficial Java implementation. Features:

Easily authenticates to Google's services
Parses CSV file as downloaded from Trends
Simply queries Trends by only configuring the request parameters
Supports Proxy configuration

A ready to use binary client for Google Trends is available here! https://github.com/elibus/j-google-trends-client/tree/master/releases/org/freaknet/gtrends/client/j-google-trends-client

Download binaries

Jar library: https://github.com/elibus/j-google-trends-api/tree/master/releases/org/freaknet/gtrends/j-google-trends-api

Example

import org.apache.http.HttpHost;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.Credentials;
import org.apache.http.auth.NTCredentials;
import org.apache.http.conn.params.ConnRoutePNames;
import org.apache.http.impl.client.DefaultHttpClient;
import org.freaknet.gtrends.api.GoogleAuthenticator;
import org.freaknet.gtrends.api.GoogleTrendsClient;
import org.freaknet.gtrends.api.GoogleTrendsCsvParser;
import org.freaknet.gtrends.api.GoogleTrendsRequest;
import org.freaknet.gtrends.api.exceptions.GoogleTrendsClientException;

public class App {

    public static void main(String[] args) throws GoogleTrendsClientException {
        String u = "myuser@gmail.com";
        String p = "mypasswd";
        
        /* OPTIONAL: setup a proxy with NTLM authentication */
        HttpHost proxy = new HttpHost("proxy.mydomain.com", 8080, "http");
        Credentials credentials = new NTCredentials("myLogin", "myPasswd", "", "DOMAIN");
        DefaultHttpClient httpClient = new DefaultHttpClient();
        httpClient.getCredentialsProvider().setCredentials(new AuthScope(proxy.getHostName(), proxy.getPort()), credentials);
        httpClient.getParams().setParameter(ConnRoutePNames.DEFAULT_PROXY, proxy);

        /* Creates a new authenticator */
        GoogleAuthenticator authenticator = new GoogleAuthenticator(u, p, httpClient);
        
        /* Creates a new Google Trends Client */
        GoogleTrendsClient client = new GoogleTrendsClient(authenticator, httpClient);
        GoogleTrendsRequest request = new GoogleTrendsRequest("bananas");
        
        /* Here the default request params can be modified with getter/setter methods */
        String content = client.execute(request);
         
        /* The default request downloads a CSV available in content */
        GoogleTrendsCsvParser csvParser = new GoogleTrendsCsvParser(content);
        /* Get a specific section of the CSV */
        String section = csvParser.getSectionAsString("Top searches for", true);
        System.out.println(section);
    }
}

HOW TO AVOID GOOGLE'S IMPOSED LIMITS

Google has imposed new policies to restrict traffic from bots, these can be circumvented by using a set of anonimous proxies like https://www.hidemyass.com/ . A new proxy has to be setup after 4 requests max.

CREDITS

Based on the original python version available here: https://github.com/suryasev/unofficial-google-trends-api

LICENSE

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.