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 | 系统错误 |