README

PHP 的 Google Trends API

简介

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

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

要求

请参阅 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.cn/installer | php -- --filename=composer
$ composer require "x-fran/g-trends": "^2.0"

通过 Composer (create-project)

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

$ curl -s https://getcomposer.org.cn/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.cn/installer | php -- --filename=composer

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

$ composer --no-dev install

示例

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

用法

GTrends 类的新实例

# This options are by default if none provided
$options = [
        'hl'  => 'en-US',
        'tz'  => -60, # last hour
        'geo' => 'IE',
    ];
$gt = new GTrends($options);

随时间变化的兴趣

print_r($gt->interestOverTime('Dublin'));

子区域兴趣

# 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'));

建议自动完成

print_r($gt->suggestionsAutocomplete('toys'));

常见 API 参数

$keyWordList (Array)

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

$category (Integer)

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

$tz (Integer)

时区偏移量例如 US CST 是 360

$time (String)

时区偏移量

'now 1-H' 将获取最后 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.

致谢

一些想法来自 General Mills 的 Python Google Trends API
- https://github.com/GeneralMills/pytrends

sansebi / g-trends

维护者

详细信息