小宿智能搜索（长摘要版）
公共信息
参数说明
| 参数 | 描述 |
|---|---|
| BasePath | 调用 API 的基础路径 |
| Endpoint | 调用 API 时生成的一段随机路径 |
| AccessKey | 调用 API 的 AccessKey |
请求路径
http://{BasePath}/search/{Endpoint}/full
请求方法
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 不设范围，设置较大时，会导致搜索结果为空。 |
| 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更智能，长度介于snippet和content之间 |
| 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}/full?q=北京有什么好吃的' \
--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}/full"
payload = {
"q": "北京有什么好吃的"
}
headers = {
'Authorization': f'Bearer {AK}',
'pragma': 'no-cache'
}
response = requests.get(url, headers=headers, params=payload)
print(response.text)
返回示例
{
"queryContext": {
"originalQuery": "北京有什么好吃的"
},
"webPages": {
"value": [
{
"name": "北京好吃的美食排名前十，道道都是经典，全部吃过的都是高手|豆汁|焦圈|烤鸭|小吃|爆肚|咸菜|炸酱面|北京市_网易订阅",
"url": "https://www.163.com/dy/article/K473SLD90556ELOV.html",
"datePublished": "2025-07-11T00:00:00.0000000",
"displayUrl": "https://www.163.com/dy/article/K473SLD90556ELOV.html",
"snippet": "北京，这座承载着千年历史的古都，不仅以故宫、长城闻名于世，更以丰富多样的美食征服了无数吃货的心。2025年最新北京美食榜单揭晓，北京烤鸭、老北京炸酱面、豆汁焦圈稳坐前三，后七名更是汇聚了宫廷御膳、市井小吃与清真风味。本文带你解锁地道京味，文末附吃货指南，速来收藏！ 第一 ...",
"dateLastCrawled": "2025-07-14T00:09:00.0000000Z",
"contentCrawled": "true",
"siteName": "网易",
"content": "<html><body><div>北京，这座承载着千年历史的古都，不仅以故宫、长城闻名于世，更以丰富多样的美食征服了无数吃货的心。2025年最新北京美食榜单揭晓，北京烤鸭、老北京炸酱面、豆汁焦圈稳坐前三，后七名更是汇聚了宫廷御膳、市井小吃与清真风味。本文带你解锁地道京味，文末附吃货指南，速来收藏！<p><img src=\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F23b3df93j00sz8caw008od000yi01frm.jpg&thumbnail=660x2147483647&quality=80&type=jpg\"/></p>第一名：北京烤鸭——宫廷名菜的“现代传奇”必吃理由：被誉为“天下美味”，是北京美食的绝对C位，2025年继续蝉联榜单冠军。特色亮点：古法烤制：选用北京填鸭，果木炭火烤制，鸭皮酥脆如琥珀，鸭肉细嫩多汁，传统“挂炉”与“焖炉”两派技艺均被列入国家级非物质文化遗产。M.ipvpd.cN/415仪式感吃法：薄如蝉翼的荷叶饼，卷上鸭肉、甜面酱、黄瓜丝、葱丝，一口咬下，脂香与酱香在舌尖绽放。创新体验：大董烤鸭店推出“酥不腻”版本，鸭皮更脆，脂肪含量更低；全聚德则保留老式果木烤炉，烟火气十足。推荐店铺：大董烤鸭店（工体店）：创新“酥不腻”烤鸭，皮脆肉嫩，搭配黑鱼子酱，奢华感拉满。全聚德（前门店）：百年老字号，烤鸭技艺传承，鸭架可熬汤，一鸭两吃。文化彩蛋：烤鸭源自南北朝《食珍录》的“炙鸭”，曾是宫廷御膳，如今成为全球吃货的“北京朝圣单品”。<p><img src=\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F3c983fcfj00sz8caw003pd000yi00n1m.jpg&thumbnail=660x2147483647&quality=80&type=jpg\"/></p>第二名：老北京炸酱面——市井生活的“酱香诗篇”必吃理由：一碗面，半部京味史，2025年入选“北京非遗美食”，是老北京人魂牵梦萦的家常味道。特色亮点：秘制炸酱：六必居干黄酱与甜面酱3:1黄金比例，五花肉丁煸炒至透明，酱香浓郁不寡淡，传统做法需小火慢熬1小时。配菜哲学：“七碟八碗”是标配：黄瓜丝、芹菜末、黄豆嘴、青豆、萝卜缨、香椿芽、青蒜末，缺一不可。手擀面魂：面条需“一窝丝”手擀，煮至八分熟过冷水，筋道不坨，浇上两勺炸酱，配新蒜，梁实秋笔下“酱香浓郁，面条滑爽”的绝妙搭配。推荐店铺：方砖厂69号炸酱面（南锣鼓巷店）：网红老店，炸酱现熬，配菜齐全，谢霆锋曾专程打卡。M.ipvpd.cN/145海碗居（增光路店）：老北京氛围拉满，炸酱面配炸灌肠、芥末墩，适合家庭聚餐。文化彩蛋：炸酱面起源与“穷人乐”有关，旧时百姓用边角料创造美味，如今成为“北京味道”的象征。<p><img src=\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2Fbb269bb5j00sz8caw004qd000yi01fwm.jpg&thumbnail=660x2147483647&quality=80&type=jpg\"/></p>第三名：豆汁焦圈——酸涩与酥脆的“京城哲学”必吃理由：老北京早餐的“灵魂CP”，2025年入选“中国地域十大名小吃”，外地人皱眉，本地人上头。特色亮点：发酵奇迹：绿豆淀粉剩余液发酵3天，表面起白沫，酸涩中带乳香，初尝者需配焦圈“中和”。焦圈工艺：面团加盐、碱、矾，醒发后切环形，热油炸至金黄，咬下“嘎吱”作响，与豆汁的酸涩形成味觉平衡。市井仪式：老北京人喝豆汁必配焦圈、咸菜丝，尹三豆汁店提供免费咸菜，地道又贴心。推荐店铺：尹三豆汁（东晓市店）：30年老店，豆汁酸度适中，焦圈酥脆，老客标配。M.ipvpd.cN/465老磁器口豆汁店（天坛店）：传统风味，豆汁浓稠，配炸灌肠，适合体验“老北京早晨”。文化彩蛋：豆汁源自辽宋，曾是民间“变废为宝”的智慧，如今成为“京城活化石”，喝的是味道，品的是历史。<p><img src=\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F50030f92j00sz8caw0056d000xc00p0m.jpg&thumbnail=660x2147483647&quality=80&type=jpg\"/></p>后七名速览：北京味道的“全景地图”卤煮火烧：大肠、肺头老汤卤制，配火烧，推荐小肠陈（非遗技艺）、北新桥卤煮（24小时营业）。铜锅涮羊肉：清水锅底配手切羊肉，东来顺（涮肉技艺）、聚宝源（手切羊肉）必吃。爆肚：牛百叶焯水5秒，蘸麻酱小料，爆肚冯（百年老店）、老爆肚满（性价比高）。京酱肉丝：猪里脊配甜面酱，大董（创意京菜）、四季民福（景观位）推荐。褡裢火烧：猪肉西葫芦馅，形似褡裢，门框胡同（现包现煎）、紫光园（清真老字号）必尝。炸灌肠：淀粉灌肠炸焦，蘸蒜汁，丰年灌肠（传统石臼捣蒜汁）、合义斋（老北京风味）。豌豆黄：白豌豆制成，清宫御点，护国寺小吃（品种丰富）、仿膳饭庄（宫廷风味）推荐。<p><img src=\"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F4f7bdb9bj00sz8caw003ed000yi00n0m.jpg&thumbnail=660x2147483647&quality=80&type=jpg\"/></p>吃货Tips烤鸭搭配：大董的“酥不腻”配黑鱼子酱，全聚德的鸭架汤别错过。炸酱面吃法：要求“锅挑儿”（不过水）更筋道，配新蒜更地道。豆汁挑战：初尝配焦圈，老客加咸菜丝，尹三豆汁提供免费小菜。卤煮火烧：可加醋、辣椒油，小肠陈有素卤煮可选。铜锅涮肉：先涮肉后涮菜，东来顺的糖蒜解腻一绝。北京的美食，是宫廷御膳的精致，也是市井小吃的烟火，从一碗烤鸭里能尝出千年的皇城气象，从一勺炸酱中能看见老北京人的生活智慧。你最爱哪款北京味道？快来评论区晒出你的“京味记忆”！ </div></body></html>",
"logo": "https://static.ws.126.net/163/f2e/common/share-icon.png",
"imageList": [
"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2Fbb269bb5j00sz8caw004qd000yi01fwm.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F4f7bdb9bj00sz8caw003ed000yi00n0m.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F50030f92j00sz8caw0056d000xc00p0m.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F23b3df93j00sz8caw008od000yi01frm.jpg&thumbnail=660x2147483647&quality=80&type=jpg",
"https://nimg.ws.126.net/?url=http%3A%2F%2Fdingyue.ws.126.net%2F2025%2F0711%2F3c983fcfj00sz8caw003pd000yi00n1m.jpg&thumbnail=660x2147483647&quality=80&type=jpg"
]
}
]
}
}