Download the PHP package samuelfa/g-trends without Composer
On this page you can find all versions of the php package samuelfa/g-trends. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download samuelfa/g-trends
More information about samuelfa/g-trends
Files in samuelfa/g-trends
Informations about the package g-trends
g-trends
Google Trends API for PHP
Introduction
This is an unofficial Google Trends API for PHP.
Please notice that the good functionality of this API depends on Google's willing to keep the backward compatibility and/or the parameters, naming and/or required values.
If this happens, feel free to contribute or open an issue.
Requirements
Please see the composer.json file.
Installation
Via Composer (require)
If you have composer installed globally
If you use composer.phar local
Via Composer (create-project)
You can use the create-project
command from Composer
to create the project in one go (you need to install composer):
Via Git (clone)
First, clone the repository:
At this point, you need to use Composer to install dependencies. Assuming you already have Composer:
Demo
To see a demo output from all methods (okay, functions) please open in your favorite browser the index.php
Usage
New instance of the class GTrends
# This options are by default if none provided
$options = [
'hl' => 'en-US',
'tz' => -60, # last hour
'geo' => 'IE',
];
$gt = new GTrends($options);
Interest Over Time
print_r($gt->interestOverTime('Dublin'));
Related Queries
# You can add up to 5 keywords
print_r( $gt->relatedQueries(['Dublin', 'Madrid', 'Paris']));
Trending Searches
# p54 is Google's tricky and wired code for Ireland
print_r($gt->trendingSearches('p54', date('Ymd')));
Interest by Subregion
# You can add up to 5 keywords
# Parameter $resolution (optional) for United States 'Subregion', 'Metro', 'City'
# Parameter $resolution (optional) for the rest of the countries 'Subregion', 'City' only
print_r($gt->relatedQueries(['Dublin'], 'City'));
Top Charts
# Parameters
# date '201708' for September 2017
# cid (category id) only able to choose from those listed on https://www.google.com/trends/topcharts
print_r($gt->topCharts('201708', 'basketball_players'));
Suggestions Autocomplete
print_r($gt->suggestionsAutocomplete('toys'));
Common API parameters
$keyWordList (Array)
Array of keywords (up to 5) to get data for
$category (Integer)
Search by category Please view this wiki page containing all available categories
$tz (Integer)
Timezone Offset For example US CST is
$time (String)
Timezone Offset
would get data from last hour (default)
would get data from today to 2 days ago
would get data from today to 3 months ago
would get data from today to 4 years ago
Caveats
- This is not an official or supported API
- Rate Limit is not publicly known, let me know if you have a consistent estimate.
Credits
- Some ideas pulled from General Mills's Google Trends API for Python