豆包搜索
豆包搜索
文档指南
请输入
- 文档首页
豆包搜索API参考豆包搜索 Global版
复制全文
下载 pdf豆包搜索 Global版
文档反馈
问问助手本文档介绍 豆包搜索Global版 接口的输入输出参数。调用该接口可获取搜索词相关的搜索结果，您可根据这些数据适配项目使用。
- Global版 仅支持按量后付费调用，不支持订阅套餐调用；
- 查看搜索版本差异说明；
接口限流：账号维度，默认 10 QPS，接入方可根据实际需要提工单扩容。（Global版和Custom版的并发限流相互独立）
免费额度：每个火山账号每月可免费调用500次联网搜索（额度与Custom版共用，不区分SearchType、付费类型），无论是否开通付费都将被优先消耗；
认证方式
提供 API Key 一种接入方式（不支持TOP网关接入）。
- 获取API Key
- 按量计费（后付费）：登陆并进入 联网搜索控制台 - API Key管理 - 按量后付费；
- 在弹出的名称文本框中填写 API Key 名称，单击创建。
说明：请妥善保存好API Key，强烈建议您不要将其直接写入到调用模型的代码中。
- 签名构造
API Key 签名鉴权方式要求在 HTTP 请求 header 中按如下方式添加 Authorization:
Authorization: Bearer <API_KEY>
我们提供postman、python的demo文件供您使用，填写APIKEY信息后可直接发起调用
接口详情
URL
请求 Request
文搜文
文搜图
图搜图
Curl 请求示例
文搜文
curl --location 'https://open.feedcoopapi.com/search_api/global_search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
"SearchType": "web",
"Query": "北京周边游玩景点推荐",
"DocCount": 10,
"MaxSnippetLength": 1000,
"MaxImageCountPerDoc": 3
}'
文搜图
curl --location 'https://open.feedcoopapi.com/search_api/global_search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
"Query": "山东大学",
"SearchType": "image",
"DocCount": 20,
"ImageFilter": {
"ShortEdgePixelMin": 512,
"ShortEdgePixelMax": 2048,
"AspectRatioMin": 1.2,
"AspectRatioMax": 2.0
}
}'
图搜图
- 整图检索
curl --location 'https://open.feedcoopapi.com/search_api/global_search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
"Query": "",
"SearchType": "visual",
"ImageQuery": {
"Url": "https://example.com/images/query.jpg"
},
"DocCount": 10,
"MaxSnippetLength": 300
}'
- 指定图片区域检索
curl --location 'https://open.feedcoopapi.com/search_api/global_search' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {YOUR_API_KEY}' \
--data '{
"Query": "同款商品",
"SearchType": "visual",
"ImageQuery": {
"Url": "https://example.com/images/query.jpg",
"RegionOfInterest": {
"XMin": 0.15,
"YMin": 0.10,
"XMax": 0.85,
"YMax": 0.90
}
},
"DocCount": 10,
"MaxSnippetLength": 300
}'
响应 Response
ResponseMetadata
Result
GlobalSearchDocument
GlobalSearchSnippet
GlobalSearchSnippetImage
GlobalSearchThumbnailUrl
GlobalSearchDocumentInfo
GlobalSearchHostInfo
响应示例
文搜文
{
"ResponseMetadata": {
"RequestId": "20260622120000A1B2C3D4E5F6",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"TotalDocCount": 20,
"Documents": [
{
"Rank": 0,
"Url": "https://m.baike.com/wiki/%E5%A4%A9%E5%AE%89%E9%97%A8/19473746",
"Title": "天安门[天安门城楼中国国家象征]_百科",
"Snippet": [
{
"Type": "text",
"Text": "天安门[天安门城楼中国国家象征]_百科\n",
},
{
"Type": "image",
"Image": {
"Width": 1136,
"Height": 565,
"ImageUrl": "https://p3-sdbk2-media.byteimg.com/tos-cn-i-xv4ileqgde/831930a0dc184ca597585d696112278b~tplv-xv4ileqgde-cpq:q30.image",
"Alt": "",
}
},
{
"Type": "text",
"Text": "天安门是紫禁城的重要建筑，也是中国明清两代皇城的正门，位于中华人民共和国首都北京市的中心、故宫的南端。天安门是长安街的交汇点，是第一批全国重点文物保护单位。\n天安门，原名“承天门”，始建于明永乐十五年(1417年)，取“承天启运，受命于天”之意。起初是一座三层楼式的木坊。明英宗(天顺)时被烧毁。宪宗(成化)时工部尚书白圭主持修复，建成城楼。但在明朝末年，再次遭到损毁。清顺治八年(1651年)改建为“天安门”，取“受命于天，安邦治民”之意。在明清两代的500年间，天安门是皇城的正门，是新帝登基、皇后册封、颁诏天下、皇帝大婚的地方，同时也是皇帝殿试公布“三甲”(金殿传胪)、招贤取士，以及举行将领出征祭旗、御驾亲征祭路、刑部秋天提审要犯等重大仪式的场所。新中国成立后，政府曾多次主持修缮天安门，并重建了城楼上的木建筑、加厚城墙。1966年3月，河北邢台地区发生7.2级大地震，天安门城楼也受到了波及，与此同时，由于\"文革\"的爆发，天安门城楼的使用次数也显著增加。为确保安全，1969年底国务院决定:彻底拆除天安门城楼，在原址、按原规格和原建筑形式重新修建一座天安门城楼，并将建筑材料全部更新。重建时，将黄琉璃滴水和瓦当上的“龙纹”改为“葵纹”，将原大点金旋子彩画改为金龙和玺彩画。重建后天安门城楼基本保持了1651年改建的形制，只是比原来的33.87米高出了0.83米，通高达34.7米。1984年，为迎接国庆35周年，对天安门城楼重新油漆彩绘，将城楼大厅内的彩画改为“龙草和玺”和“团龙天花”彩画，外檐彩画改为“金龙和玺”彩画。1988年1月1日，天安门城楼为迎接龙年旅游年，正式对外开放。",
}
],
"DocumentInfo": {
"ContentCharCount": 10349,
"ContentTokenCount": 7173,
"Filetype": "webpage",
"PublishTime": ""
},
"HostInfo": {
"Hostname": "抖音百科",
"IconUrl": "https://p26-volcsearch-d-sign.byteimg.com/isp-i18n-media/img/42d75365f84dd9854e4482bae39dfabf~tplv-be4g95zd3a-224x224.jpeg?lk3s=feb11e32&x-expires=1787629937&x-signature=mRRnm2Fw%2BsNSJY7OpI7wGGxGBhk%3D",
"AuthorityLevel": "very_high"
}
}
],
"ErrorCode": 0,
"ErrorMsg": ""
}
}
文搜图
{
"ResponseMetadata": {
"RequestId": "20260806120000A1B2C3D4E5F6",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"TotalDocCount": 20,
"Documents": [
{
"Rank": 0,
"Url": "https://example.com/shandong-university",
"Title": "山东大学",
"Snippet": [
{
"Type": "text",
"Text": "山东大学"
},
{
"Type": "image",
"Image": {
"Width": 800,
"Height": 600,
"ImageUrl": "https://example.com/images/shandong-university.jpg",
"Alt": "山东大学"
}
}
],
"DocumentInfo": {
"ContentCharCount": 0,
"ContentTokenCount": 0,
"Filetype": "image",
"PublishTime": ""
}
}
],
"ErrorCode": 0,
"ErrorMsg": ""
}
}
图搜图
{
"ResponseMetadata": {
"RequestId": "20260820120000A1B2C3D4E5F6",
"Action": "",
"Version": "",
"Service": "",
"Region": ""
},
"Result": {
"TotalDocCount": 10,
"Documents": [
{
"Rank": 0,
"Url": "https://example.com/products/123",
"Title": "相似商品示例",
"Snippet": [
{
"Type": "text",
"Text": "与查询图片相似的商品"
},
{
"Type": "image",
"Image": {
"Width": 800,
"Height": 800,
"ImageUrl": "https://example.com/images/result.jpg",
"Alt": "相似商品示例"
}
}
],
"DocumentInfo": {
"ContentCharCount": 0,
"ContentTokenCount": 0,
"Filetype": "image",
"PublishTime": ""
},
"HostInfo": {
"Hostname": "example.com",
"IconUrl": "https://example.com/favicon.ico"
}
}
],
"ErrorCode": 0,
"ErrorMsg": "",
"Choices": null,
"Usage": null
}
}
错误请求返回示例
{
"ResponseMetadata": {
"RequestId": "20260622120000A1B2C3D4E5F6",
"Action": "",
"Version": "",
"Service": "",
"Region": "",
"Error": {
"CodeN": 10400,
"Code": "10400",
"Message": "query is empty"
}
},
"Result": null
}
错误处理
最近更新时间：2026.09.22 18:56:53
这个页面对您有帮助吗？
有用
有用
无用
无用