小宿智能搜索V2
公共信息(Smart 接口)
基础参数
| 参数 | 描述 |
|---|---|
| BasePath | 调用 API 的基础路径 |
| Endpoint | 调用 API 时生成的随机路径 |
| AccessKey | 调用 API 的 AccessKey |
请求路径
https://{BasePath}/search/{Endpoint}/smart
请求方法
GET
请求头
| 参数 | 类型 | 描述 |
|---|---|---|
| Authorization | String | 输入:Bearer {AK},其中 AK 为 AccessKey |
| Pragma | String | 输入值:no-cache。输入no-cache返回结果不开启缓存、每次独立请求;不输入则相同查询词的返回结果会有10分钟的缓存 |
请求体参数
| 参数 | 是否必填 | 类型 | 描述 |
|---|---|---|---|
| q | Y | String | 用户的搜索查询词,该词不能为空。 |
| count | N | Short | 返回结果中包含的搜索结果数量。默认值为10,最大50。 枚举值: - 10 - 20 - 30 - 40 - 50 实际返回的数量可能少于请求的数量。使用此参数和偏移量参数一起分页结果。 |
| freshness | N | String | 按以下值筛选不同时间段的搜索结果: - Day (近一天) - Week(近一周) - Month(近一个月) |
| offset | N | Short | 从零开始的偏移量,指示在返回结果之前要跳过的搜索结果数量。默认值为0。使用此参数与 count 参数一起分页显示结果。 offset不设范围,设置较大时,会导致搜索结果为空。 |
| enableContent | N | bool | 用于控制返回长摘要内容: true:返回长摘要 false:不返回长摘要 默认值为false |
| contentType | N | String | 长摘要(content)返回格式,可选值: - HTML - MARKDOWN - TEXT(默认返回TEXT) |
| contentTimeout | N | Float | 长摘要读取超时时间,即内容读取超过设置时间,会终止读取、该结果不返回长摘要信息。默认0(单位s),最大支持10s。 |
| mainText | N | bool | 用于返回动态摘要关键片段。 true:返回关键片段 false:不返回关键片段 默认值为false |
| sites | N | String | 该字段的值需填写host地址格式(示例:baijiahao.baidu.com),填写后返回指定站点的结果 |
| blockWebsites | N | String | 该字段的值需填写host地址格式(示例:baijiahao.baidu.com),填写后去除指定站点的结果 |
返回值说明
| 字段 | 类型 | 描述 |
|---|---|---|
| queryContext.originalQuery | String | 用户的原始搜索词 |
| webPages.value | Array | 返回的详细结果数据。 |
| webPages.value.name | String | 网页标题 |
| webPages.value.url | String | 网页 URL |
| webPages.value.datePublished | String | 页面发布时间,部分网站包含 示例: 2025-07-14T01:15:00.0000000Z |
| webPages.value.snippet | String | 描述网页内容的文本短摘要 |
| webPages.value.mainText | String | 从正文中提取的与查询词最相关的动态摘要片段。相较snippet更智能 |
| webPages.value.siteName | String | 网站名称(部分网页包含) |
| webPages.value.contentCrawled | Bool | 长摘要读取状态:true 成功,content包含内容 false 失败,content为空 |
| webPages.value.content | String | 网页长摘要信息。读取自网页的正文。 MARKDOWN、HTML格式包含有锚点位置的图片链接 |
| webPages.value.logo | String | 网站 logo(部分网页包含) |
| webPages.value.imageList | Array | 网页中的图片地址列表(部分网页包含,是否包含取决于网页页面内是否有图) |
| webPages.value.score | Float | 内容相关性分数 |
请求示例
cURL
curl --location --request GET 'https://{basePath}/search/{endpoint}/smart?q=cat&count=10&mainText=true&enableContent=true' \
--header 'Authorization: Bearer {AK}' \
--header 'pragma: no-cache'
Python(Requests)
import requests
BasePath = 'xxxxxx' # 请替换为您获取到的 BasePath
Endpoint = 'xxxxxx' # 请替换为您获取到的 Endpoint
AK = 'xxxxxx' # 请替换为您获取到的 AK
url = f"https://{BasePath}/search/{Endpoint}/smart"
payload = {
"q": "cat",
"count": 10,
"enableContent": True,
"mainText": True
}
headers = {
'Authorization': f'Bearer {AK}',
'Pragma': 'no-cache'
}
response = requests.get(url, headers=headers, params=payload)
print(response.text)
返回示例
{
"queryContext": {
"originalQuery": "cat"
},
"webPages": {
"value": [
{
"name": "cat - 搜狗百科",
"url": "http://baike.sogou.com/v64497242.htm?fromTitle=cat",
"datePublished": "2024-07-31T06:25:29.0000000",
"snippet": "cat(英[kæt],美[kæt]),英语单词。作名词时,释义为猫;猫科动物;心地恶毒的女人。作动词时,释义为把(锚)吊放在锚架上;用九尾鞭打;<英俚> 呕吐。作缩写词时,释义为(CAT)晴空湍流;计算机辅助测试。 中文名 猫 外文名 cat 另一含义 国际公认会计技师 类型 英语单词 基本介绍 猫:猫科的动物:猫的身体分为头、颈、躯干、四肢和尾五部分,大多数全身披毛,少数为无毛猫。",
"siteName": "搜狗百科",
"content": "cat(英[kæt],美[kæt]),英语单词。作名词时,释义为猫;猫科动物;心地恶毒的女人。作动词时,释义为把(锚)吊放在锚架上;用九尾鞭打;<英俚> 呕吐。作缩写词时,释义为(CAT)晴空湍流;计算机辅助测试。短语搭配为pet cat(宠物猫)。例句为“It is a large-sized wild cat.(它是一个体型很大的野猫。)” cat的复数为cats,现在分词为catting,过去分词为catted。其反义词为keep down,名词性近义词为pussy-cat、grimalkin[1]。英语单词cat(英[kæt],美[kæt]),英语单词。作名词时,释义为猫;猫科动物;心地恶毒的女人。作动词时,释义为把(锚)吊放在锚架上;用九尾鞭打;<英俚> 呕吐。作缩写词时,释义为(CAT)晴空湍流;计算机辅助测试。短语搭配为pet cat(宠物猫)。例句为“It is a large-sized wild cat.(它是一个体型很大的野猫。)” cat的复数为cats,现在分词为catting,过去分词为catted。其反义词为keep down,名词性近义词为pussy-cat、grimalkin[1]。 免责声明 搜狗百科词条内容由用户共同创建和维护,不代表搜狗百科立场。如果您需要医学、法律、投资理财等专业领域的建议,我们强烈建议您独自对内容的可信性进行评估,并咨询相关专业人士。 词条信息词条浏览:45555次 最近更新:24.07.31 编辑次数:12次 创建者:兔子... 突出贡献者:",
"contentCrawled": "true",
"logo": "http://search.sogoucdn.com/baike/common/favicon.d5e2980b.ico",
"score": 0.6703299,
"imageList": [],
"mainText": "短语搭配为pet cat(宠物猫)。例句为“It is a large-sized wild cat.(它是一个体型很大的野猫。)” cat的复数为cats,现在分词为catting,过去分词为catted。其反义词为keep down,名词性近义词为pussy-cat、grimalkin[1]。英语单词cat(英[kæt],美[kæt]),英语单词。作名词时,释义为猫;猫科动物;心地恶毒的女人。作动词时,释义为把(锚)吊放在锚架上;用九尾鞭打; 呕吐。作缩写词时,释义为(CAT)晴空湍流;计算机辅助测试。短语搭配为pet cat(宠物猫)。例句为“It is a large-sized wild cat.(它是一个体型很大的野猫。)” cat的复数为cats,现在分词为catting,过去分词为catted。其反义词为keep down,名词性近义词为pussy-cat、grimalkin[1]。 免责声明 搜狗百科词条内容由用户共同创建和维护,不代表搜狗百科立场。如果您需要医学、法律、投资理财等专业领域的建议,我们强烈建议您独自对内容的可信性进行评估,并咨询相关专业人士。 词条信息词条浏览:45555次 最近更新:24.07.31 编辑次数:12次 创建者:兔子... 突出贡献者:"
},
{
"name": "Cat是什么单词",
"url": "https://www.kaoshibaike.com/396832178.html",
"datePublished": "2024-01-06T08:44:52.0000000",
"snippet": "小写cat译为中文是猫的意思,大写的CAT是指化学中的过氧化氢酶和计算机程序中的计算机辅助翻译。同时CAT也是卡特彼勒公司的缩写和一著名品牌休闲服装和鞋类。另外CAT还是国际公认会计技师。 CAT是英文Certified Accounting Technician的缩写,.该资格证书是由特许公认会计师公会(ACCA)授予、国际认可的会计专业资格。",
"content": "小写cat译为中文是猫的意思,大写的CAT是指化学中的过氧化氢酶和计算机程序中的计算机辅助翻译。同时CAT也是卡特彼勒公司的缩写和一著名品牌休闲服装和鞋类。另外CAT还是国际公认会计技师。 CAT是英文Certified Accounting Technician的缩写,.该资格证书是由特许公认会计师公会(ACCA)授予、国际认可的会计专业资格。",
"contentCrawled": "true",
"logo": "https://www.kaoshibaike.com/favicon.ico",
"score": 0.5712132,
"imageList": [],
"mainText": "小写cat译为中文是猫的意思,大写的CAT是指化学中的过氧化氢酶和计算机程序中的计算机辅助翻译。同时CAT也是卡特彼勒公司的缩写和一著名品牌休闲服装和鞋类。另外CAT还是国际公认会计技师。 CAT是英文Certified Accounting Technician的缩写,.该资格证书是由特许公认会计师公会(ACCA)授予、国际认可的会计专业资格。"
}
]
}
}
状态码说明
| 状态码 | 错误码 | 描述 |
|---|---|---|
| 200 | - | 接口调用成功 |
| 429 | - | qps 超限,需要联系工作人员提升额度 |