QingSearch搜索数据开放
QingSearch - web search 项目（原rambler.hk）自2016年运行至今，搜索引擎机器人已经抓取了海量的网站页面信息；目前已经涵盖了中文、繁体中文、英文、日文、韩文、俄文、德文、泰文等语言的海量网页信息。
QingSearch允许开发者使用搜索REST API进行构建自己的稳定的搜索引擎。
搜索开放API是在接收应用程序 GET 请求时返回搜索结果的非登录 Open API。
说明：在使用搜索数据开放API时，应当在明显部位标示，搜索技术：
API基本信息
| 请求方式 | 请求URL | 鉴权 | 版本 | 请求限制 | 输出格式 |
| GET | https://qingsearch.com/open/api/v1/search.json | 是 | v1 | 10000次/日 | JSON |
请求参数
| 字段 | 是否必须 | 类型 | 描述 |
| query | 是 | 文本字符串 | 关键词、字符串长度1~30 |
| start | 是 | 整数 | 索引初始值、默认1；小于1无效；最大值200；、计算方式：（页码*15+1） |
| ouid | 是 | 字符串 | 开放平台的UserID(OpenUid) |
| token | 是 | 字符串 | 数据请求鉴权、“开放平台UserID(OpenUid)”和“搜索关键词”和“开放平台密钥(OpenSecret)”字符串拼接，再进行md5加密； 生成方式: md5(OpenUid+query+OpenSecret) |
| region | 否 | 字符串 | 地区：cn — 国内、cnhk - 中国香港地区、cntw - 中国台湾地区、kr - 韩语地区、ru - 俄语地区、jp - 日语地区、de - 德语地区、en - 英语地区、ta - 泰语地区、默认 all 不限地区 |
| adult | 否 | 整数 | 是否限制成人内容、取值范围 0 或 1；0为不限制；1为开启限制 该值默认为1、启用限制过滤内容、不支持设置 |
请求示例
<?php$OpenUid = "开放平台的UserID";
$OpenSecret = "开放平台的密钥";
$query="千语创想";
$token=md5($OpenUid.$query.$OpenSecret);
$start=1;
$url = "https://qingsearch.com/open/api/v1/search.json?query=".urlencode($query)."&start=".$start."&ouid=".$OpenUid."&token=".$token;
$is_post = false;
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, $is_post);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$headers = array();
$headers[] = "X-QingSearch-Open-Id: ".$OpenUid;
$headers[] = "X-QingSearch-Open-Secret: ".$OpenSecret;
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec ($ch);
$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
echo "status_code:".$status_code;
curl_close ($ch);
if($status_code == 200)
{
echo $response;
}
else
{
echo "Error：".$response;
}
?>
返回数据
(json格式)| 字段 | 描述 |
| statuscode | 状态码 |
| lastBuildDate | 最后索引创建时间 |
| display | 显示数量 |
| start | 当前结果集索引序列起始值 |
| adult | 成人内容过滤标识 |
| region | 地区 |
| items | 搜索结果集 |
| title | 页面标题，（items搜索结果集里面的值） |
| description | 页面描述，（items搜索结果集里面的值） |
| link | 页面链接，（items搜索结果集里面的值） |
返回示例
状态码说明
| 状态码 | 描述 |
| 200 | 请求成功 |
| 300 | 缺少必要参数 |
| 110 | 鉴权失败 |
| 500 | 系统错误 |