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搜索结果集里面的值)

返回示例

{ "statuscode": "200", "lastBuildDate": "2021-08-08 01:23:45UTC/GMT+08:00", "display": "1", "start": "1", "adult": "1", "region": "cn", "items": [ { "title": "QingSearch(轻搜搜索引擎)- 尊重你隐私的搜索引擎", "description": "我们不追踪你,无关乎隐私浏览,我们从不存储你的个人信息,我们没有缠着你不放的广告, 我们不记录你的搜索历史,自然也就没什么东西卖给想追踪你的广告商。", "link": "https://www.qingsearch.com/" } ] }

状态码说明

状态码 描述
200 请求成功
300 缺少必要参数
110 鉴权失败
500 系统错误