跳转至

serp搜索

公共信息

参数 描述 示例
basePath 调用mass api的基础路径 https://searchapi.cloudsway.net/
endpointPath 调用mass api的生成的一段随机路径
AccessKey 调用mass api的accessKey RWxxxxxxxx0Gd

请求方法

GET

请求路径

{basePath}/search/{endpointPath}/serp

参数 描述 示例
Authorization AccessKey
Bearer ${AccessKey}
Bearer RWxxxxxxxx0Gd
pragma string no-cache 不开启缓存

请求params

字段名 类型 是否必填 描述
count string 返回结果中包含的搜索结果数量
freshness string 按以下不区分大小写的时间值筛选搜索结果:Day、Week、Month。要获取在特定时间范围内发现的文章,请指定格式为YYYY-MM-DD..YYYY-MM-DD的日期范围。例如,&freshness=2019-02-01..2019-05-30。
q string 用户的搜索查询词。该词不能为空。查询词可以包含Bing高级操作符。

返回值

Response

字段名 类型 描述
queryContext object 图片审核结果
webPages string Custom Search JSON API 的 OpenSearch 网址模板的 MIME 类型。

QueryContext

字段名 类型 描述
originalQuery string 请求中指定的查询字符串。

webPages

字段名 类型 描述
value WebPage[] 与查询相关的网页列表。

webPage

字段名 类型 描述
name String 网页的名称。使用此名称和url创建一个超链接,用户点击时会转到网页。
snippet String 描述网页内容的文本片段。
url String 网页的URL。使用此URL和name创建一个超链接,用户点击时会转到网页。
## 示例

请求

curl --location --request GET 'https://searchapi.cloudsway.net/search/{endpointPath}/serp?q=cat' \
--header 'Authorization: Bearer  ${AccessKey}  ' \
--header 'pragma: no-cache' \
--header 'X-Search-Location;' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)'

返回值

{
  "queryContext": {
    "originalQuery": "cat"
  },
  "webPages": {
    "value": [
      {
        "name": "Cat - Reddit",
        "url": "https://www.reddit.com/r/cat/",
        "snippet": "As a cat subreddit, we only allow cat related things for example: videos, memes, pictures or advice. Any comment or post which isn't cat related will be removed. This rule doesn't include …"
      }
    ]
  }
}