跳转至

智能搜索

公共信息

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

请求方法

GET

请求路径

{basePath}/search/{endpointPath}/smart

参数 描述 示例
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。
offset Short 否 从零开始的偏移量，指示在返回结果之前要跳过的搜索结果数量。默认值为0。使用此参数与count参数一起分页显示结果。
q string 否 用户的搜索查询词。该词不能为空。查询词可以包含Bing高级操作符。
mkt string 否 结果来源的市场。通常，mkt是用户发出请求的国家。然而，如果用户不在Bing提供结果的国家，则可能是不同的国家。市场必须采用<语言>-<国家/地区>的形式。例如，en-US。该字符串不区分大小写。
cc string 否 一个 2 个字符的国家/地区代码，表示结果来源的国家/地区。
safeSearch string 否 用于过滤网页、图片和视频中的成人内容。以下是可能的过滤值：
Off — 返回包含成人文本和图片但不包含成人视频的内容。
Moderate — 返回包含成人文本的网页，但不包含成人图片或视频。
Strict — 不返回成人文本、图片或视频。
setLang string 否 用于用户界面字符串的语言。您可以使用2个字母或4个字母的代码来指定语言。推荐使用4个字母的代码。要指定2字母代码，请将此参数设置为ISO 639-1语言代码。要指定4字母代码，请使用-的形式，其中为ISO 639-1语言代码（中性文化），为ISO 3166国家/地区（特定文化）代码。例如，使用en-US表示美国英语。

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创建一个超链接，用户点击时会转到网页。
thumbnailUrl String 图像缩略图的URL。
datePublished String 网页发布的时间。2020-03-02T16:51:00.0000000Z
dateLastCrawled String 最后一次抓取网页的时间。2024-09-08T23:18:00.0000000Z
siteName String 网页来源
## 示例

请求

curl --location --request GET 'https://searchapi.cloudsway.net/search/{endpointPath}/smart?q=cat&safeSearch=Off' \
--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 - Wikipedia",
        "url": "https://en.wikipedia.org/wiki/Cat",
        "thumbnailUrl": "https://www.bing.com/th?id=OIP.jBq63m5ZX-icInoK4ZraVgHaEh&w=80&h=80&c=1&pid=5.1",
        "displayUrl": "https://en.wikipedia.org/wiki/Cat",
        "snippet": "Learn about the cat (Felis catus), a small domesticated carnivorous mammal and the only domesticated species of the family Felidae. Find out its origin, evolution, classification, anatomy, behavior, reproduction, and global distribution.",
        "dateLastCrawled": "2025-05-25T23:37:00.0000000Z",
        "siteName": "Wikipedia"
      }
    ]
  }
}