README

PHP的Google Trends API

简介

这是一个非官方的PHP Google Trends API。

请注意，此API的良好功能取决于谷歌愿意保持向后兼容性和/或参数、命名和/或所需值。
如果发生这种情况，请随时贡献或提出问题。

要求

请参阅composer.json文件。

安装

通过Composer（require）

如果您已全局安装Composer

$ composer require x-fran/g-trends

如果您使用composer.phar本地安装

# Get your own copy of composer.phar
$ curl -s https://getcomposer.org/installer | php -- --filename=composer
$ composer require "x-fran/g-trends": "^3.0"

通过Composer（create-project）

您可以使用Composer的create-project命令一次创建项目（您需要安装Composer）

$ curl -s https://getcomposer.org/installer | php -- --filename=composer
$ composer --no-dev create-project x-fran/g-trends path/to/install

通过Git（clone）

首先，克隆存储库

$ git clone https://github.com/x-fran/g-trends.git # optionally, specify the directory in which to clone
$ cd path/to/install
$ curl -s https://getcomposer.org/installer | php -- --filename=composer

此时，您需要使用Composer安装依赖项。假设您已经安装了Composer

$ composer --no-dev install

演示

要查看所有方法（好吧，函数）的演示输出，请在您喜欢的浏览器中打开index.php

用法

GTrends类的新的实例

use Google\GTrends;

# This options are by default if none provided
$options = [
    'hl' => 'en-US',
    'tz' => 0,
    'geo' => 'US',
    'time' => 'all',
    'category' => 0,
];
$gt = new GTrends($options);

设置代理以避免谷歌reCAPTCHA

$gt = new GTrends($options);

$gt->setProxyConfigs([
    'proxy_host' => 'your_proxy_host',
    'proxy_port' => 8000,
    'proxy_user' => 'your_proxy_user',
    'proxy_pass' => 'your_proxy_pass',
]);

$gt->setProxyConfigs(null); // clear proxy if you want

随时间变化兴趣

$gt->getInterestOverTime('Dublin');

实时搜索趋势

# Categories for Realtime Search Trends are a single char str:
$gt->getRealTimeSearchTrends('all');
#
# Categories
# all : default
# b : business
# e : entertainment
# m : health/medical
# t : sci/tech
# s : sports
# h : top stories

每日搜索趋势

$gt->getDailySearchTrends();

热门搜索

# p54 is Google's tricky and wired code for Ireland
print_r($gt->trendingSearches('p54', date('Ymd')));
#
# National Region Codes:
# IRELAND=p54
# UNITED_STATES=p1
# ARGENTINA=p30
# AUSTRALIA=p8
# AUSTRIA=p44
# BELGIUM=p41
# BRAZIL=p18
# CANADA=p13
# CHILE=p38
# COLOMBIA=p32
# CZECHIA=p43
# DENMARK=p49
# EGYPT=p29
# FINLAND=p50
# FRANCE=p16
# GERMANY=p15
# GREECE=p48
# HONG_KONG=p10
# HUNGARY=p45
# INDIA=p3
# INDONESIA=p19
# ISRAEL=p6
# ITALY=p27
# JAPAN=p4
# KENYA=p37
# MALAYSIA=p34
# MEXICO=p21
# NETHERLANDS=p17
# NEW_ZEALAND=p53
# NIGERIA=p52
# NORWAY=p51
# PHILIPPINES=p25
# POLAND=p31
# PORTUGAL=p47
# ROMANIA=p39
# RUSSIA=p14
# SAUDI_ARABIA=p36
# SINGAPORE=p5
# SOUTH_AFRICA=p40
# SOUTH_KOREA=p23
# SPAIN=p26
# SWEDEN=p42
# SWITZERLAND=p46
# TAIWAN=p12
# THAILAND=p33
# TURKEY=p24
# UKRAINE=p35
# UNITED_KINGDOM=p9
# VIETNAM=p28

建议自动完成

$gt->suggestionsAutocomplete('Milwaukee');

常见API参数

$keyWords (Array)

要获取数据的关键词数组（最多5个）

$options['category'] (Integer)

按类别搜索请查看包含所有可用类别的wiki页面

$options['tz'] (Integer)

时区偏移量例如美国CST是360

$options['time'] (String)

时区偏移量

'now 1-H'将获取最后1小时的数据
'now 1-d'将获取最后1天的数据
'today 2-d'将获取从今天到2天前的数据
'today 3-m'将获取从今天到3个月前的数据
'today 4-y'将获取从今天到4年前的数据

注意事项

- This is not an official or supported API
- Rate Limit is not publicly known, let me know if you have a consistent estimate.

致谢

一些想法来自通用米尔斯的Python Google Trends API
- https://github.com/GeneralMills/pytrends

x-fran / g-trends

维护者

详细信息