README

面向对象的关键词工具.io API客户端

这是关键词工具.io公共API的实现，可以在这里查看文档。

开始使用前，您需要有一个API密钥，该密钥将通过您的电子邮件发送，或者您可以在API选项卡中登录后获取。

快速入门

使用谷歌关键词的示例

require './vendor/autoload.php';

// Keyword which you want to research
$keyword = 'iOS';

// Trying to get all keywords related to the keyword with volume metrics
// usage country is United States (google.com) and language English
// full list of available countries and languages you can found http://keywordtool.io/api/documentation
$request = \KWTClient\RequestFactory::google($keyword)->metrics(true)->country('us')->language('en');

$client = new \KWTClient\Client('[YOUR-API-KEY]');
$response = $client->research($request);

// will display
// Array
// (
//     [0] => Array
//         (
//             [kw] => ios
//             [vol] => 74000
//         )
//    ....

print_r($response->getKeywords());

但服务还提供获取youtube、appstore和bing关键词建议的可能性。

对于youtube

....
$request = \KWTClient\RequestFactory::youtube('iOS');
....

对于appstore

....
$request = \KWTClient\RequestFactory::appstore('iOS');
....

对于bing

....
$request = \KWTClient\RequestFactory::bing('iOS');
....

RequestFactory返回请求支持的参数

country($countryCode = 'us')

查找关键词建议的国家。例如，如果您将$countryCode声明为'ar'（阿根廷），它将查找通过google.com.ar搜索的关键词。不同服务的国家代码列表可在这里找到 - "country"参数的值

language($language = 'en')

关键词建议的语言。不同服务的语言代码列表可在这里找到 - "language"参数的值

excludeKeywords(array $keywords = [])

使用此参数指定负面关键词，即您想要排除在结果之外的关键词。例如，包含"keyword=iphone&exclude=case|game|price"的API调用将返回"iphone"的关键词建议，但不会包含包含单词"case"、"game"或"price"的关键词建议。这意味着关键词建议"best iphone price"不会出现在结果中。

metrics($flag = false)

如果此参数设置为"true"，则允许获取英文关键词的搜索量、CPC和AdWords竞争数据。

type($type = 'suggestions')

搜索查询类型。可用类型为："suggestions"和"questions"。

complete($flag = false)

允许获取完整的自动补全结果集。请注意，如果此参数设置为"true"，则可能有一定比例的请求会返回错误。

贡献

欢迎为该客户端添加任何您想要的内容。您只需运行单元测试，以确保您的提交不会破坏客户端。并且请为您的pull请求编写单元测试。

composer install --dev
./vendor/bin/phpunit --testsuite=unit

参考

完整的API文档可以在此找到：http://keywordtool.io/api/documentation

许可协议

请使用本指南。感谢您的认可。

版权信息

版权（c）2014-2016 Oleksii Mylotskyi

（MIT许可协议）特此授予任何人免费获得本软件及其相关文档副本（以下简称“软件”）的权利，无限制地处理该软件，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本，并允许向提供软件的个人授予此类权利，但须遵守以下条件：上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。软件按“现状”提供，不提供任何形式的质量保证，无论是明示的、暗示的，还是关于适销性、特定用途适用性或非侵权的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是基于合同、侵权或其他原因引起的，无论是源于、因之发生还是与此软件的使用或其他交易有关。