全部开发文档
选择文档

产品概述

产品简介

快速入门

快速入门

API 参考

小宿智能搜索 V1
小宿智能搜索 V2

小宿智能搜索V2

本页目录公共信息(Smart 接口)基础参数请求路径请求方法请求头请求体参数返回值说明请求示例cURLPython(Requests)返回示例状态码说明

公共信息(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]),英语单词。作名词时,释义为猫;猫科动物;心地恶毒的女人。作动词时,释义为把(锚)吊放在锚架上;用九尾鞭打;&lt;英俚&gt; 呕吐。作缩写词时,释义为(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 超限,需要联系工作人员提升额度

您的 AI 之旅,从这里启航

作为专为开发者与企业打造的前沿 AI 基础设施,
我们将为您提供完善的 AI 基础设施与专业指导,助力打造最适合您业务的完美解决方案。

联系我们