Web Search
为您的AI应用接入联网检索,不再局限于自身知识,释放更多可能性。
高速稳定
秒级响应(1-4s),确保您的应用流畅运行
全天候数据采集
实时性高,保证搜索结果的时效性
快速集成
支持多种调用方式,兼容Bing Search API
结果重排
通过先进的重排模型,针对搜索语义进行重排
内容更详尽
提供网页更多的信息,便于大模型理解
多模态内容
同时提供文字和图像,可用于预览和多模态大模型理解
应用场景
为联网AI助手提供实时数据查询能力,确保信息的准确性和时效性
垂直领域智能搜索,为特定行业提供定制化搜索和内容聚合服务
舆情监控与信息预警,自动追踪关键词变化并及时发送通知
高级语义重排功能,根据查询意图智能筛选和排序搜索结果,提供更精准的信息
GET 请求
https://api.unifuncs.com/api/web-search/search?query=今日金价&apiKey=API_KEY
请求头
Content-Type: application/json
Authorization: Bearer API_KEY
请求参数
参数名 | 类型 | 必需 | 描述 |
---|---|---|---|
query | string | 是 | 搜索关键词,如:今日金价 |
apiKey | string | 是 | API密钥(也可通过Authorization头传送) |
area | string | 否 | 搜索地区,可选值:cn、global,分别代表中国范围和全球范围,默认为cn * 注意:cn地区搜索结果通常经过审查,因此可能不如global地区全面,如您使用global地区搜索,请确保您的应用符合当地法律法规 |
freshness | string | 否 | 结果时效性,可选值:Day、Week、Month、Year |
summary | boolean | 否 | 是否返回更详细的摘要,默认值为true |
page | number | 否 | 页码,默认值为1 |
count | number | 否 | 每页结果数量(1-50),默认值为10 |
format | string | 否 | 返回格式,可选值:json、markdown、md、text、txt,默认值为json |
POST 请求
https://api.unifuncs.com/api/web-search/search
请求头
Content-Type: application/json
Authorization: Bearer API_KEY
请求体
{
"query": "今日金价",
"page": 1,
"count": 5
}
请求参数
参数名 | 类型 | 必需 | 描述 |
---|---|---|---|
query | string | 是 | 搜索查询词,如:今日金价 |
area | string | 否 | 搜索地区,可选值:cn、global,分别代表中国范围和全球范围,默认为cn * 注意:cn地区搜索结果通常经过审查,因此可能不如global地区全面,如您使用global地区搜索,请确保您的应用符合当地法律法规 |
freshness | string | 否 | 结果时效性,可选值:Day、Week、Month、Year |
summary | boolean | 否 | 是否返回摘要,默认值为true |
page | number | 否 | 页码,默认值为1 |
count | number | 否 | 每页结果数量(1-50),默认值为10 |
format | string | 否 | 返回格式,可选值:json、markdown、md、text、txt,默认值为json |
MCP接入
使用MCP协议快速将UniFuncs API能力接入到您的大模型系统:https://github.com/UniFuncs/ufn-mcp-server
STDIO通信
{
"mcpServers": {
"unifuncs": {
"command": "npx",
"args": [
"-y",
"@unifuncs/ufn-mcp-server"
],
"env": {
"UNIFUNCS_API_KEY": "sk-**********"
}
}
}
}
SSE通信
https://mcp.unifuncs.com/sse
需在headers请求头中添加Authorization: Bearer sk-**********
兼容BingSearch
您可以直接替换您的 BingSearch API 降低成本:https://api.unifuncs.com/api/web-search/v7.0/search
Bing兼容参数
参数名 | 类型 | 描述 |
---|---|---|
q | string | 等同于query参数,搜索关键词 |
offset | number | 结果偏移量,用于与page和count一起计算分页 |
响应格式
1{
2 "code": 0,
3 "message": "OK",
4 "data": {
5 "webPages": [
6 {
7 "name": "今日金价行情(2025/05/13 08:00)! - 今日头条",
8 "url": "https://www.toutiao.com/article/7503726998365159999/",
9 "displayUrl": "https://www.toutiao.com/article/7503726998365159999/",
10 "snippet": "2025/05/13\n08:00实时金价~觉得实用的话,在底部来个“分享、点赞、关注”呗~种类人民币(元/克)国际(美元/盎司)黄金Au销售755.043234.79回购751.423219.29白银",
11 "summary": "2025/05/13\n08:00实时金价~觉得实用的话,在底部来个“分享、点赞、关注”呗~种类人民币(元/克)国际(美元/盎司)黄金Au销售755.043234.79回购751.423219.29白银Ag销售7.59932.56回购7.38931.66铂金Pt销售228.42978.63回购227.37974.13钯金Pd销售220.59945.1回购219.52940.5*\n以上仅供参考,结算以实时金价为准!单位换算:1盎司=31.10348克今日实时汇率:在岸人民币汇率7.2029离岸人民币汇率7.1985<script\ntype="text/javascript"\nsrc="//mp.toutiao.com/mp/agw/mass_profit/pc_product_promotions_js?item_id=7503726998365159999"></script>",
12 "siteName": "今日头条",
13 "siteIcon": "https://api.cn-hongkong.unifuncs.com/siteicon/7777772e746f757469616f2e636f6d7c3238646637316262",
14 "datePublished": "2025-05-13T08:59:00+08:00"
15 },
16 {
17 "name": "现货黄金刚刚跌破3250.00美元/盎司关口_腾讯新闻",
18 "url": "https://news.qq.com/rain/a/20250513A051CO00",
19 "displayUrl": "https://news.qq.com/rain/a/20250513A051CO00",
20 "snippet": "每经AI快讯,5月13日,现货黄金刚刚跌破3250.00美元/盎司关口,最新报3249.93美元/盎司,日内涨0.47%;COMEX黄金期货主力最新报3254.40美元/盎司,日内涨0.82%。每日经",
21 "summary": "每经AI快讯,5月13日,现货黄金刚刚跌破3250.00美元/盎司关口,最新报3249.93美元/盎司,日内涨0.47%;COMEX黄金期货主力最新报3254.40美元/盎司,日内涨0.82%。每日经济新闻",
22 "siteName": "腾讯网",
23 "siteIcon": "https://api.cn-hongkong.unifuncs.com/siteicon/6e6577732e71712e636f6d7c6131323961643465",
24 "datePublished": "2025-05-13T14:14:00+08:00"
25 },
26 {
27 "name": "现货黄金刚刚突破3260.00美元/盎司关口_腾讯新闻",
28 "url": "https://news.qq.com/rain/a/20250513A04PT700",
29 "displayUrl": "https://news.qq.com/rain/a/20250513A04PT700",
30 "snippet": "每经AI快讯,5月13日,现货黄金刚刚突破3260.00美元/盎司关口,最新报3260.01美元/盎司,日内涨0.78%;COMEX黄金期货主力最新报3264.60美元/盎司,日内涨1.13%。每日经",
31 "summary": "每经AI快讯,5月13日,现货黄金刚刚突破3260.00美元/盎司关口,最新报3260.01美元/盎司,日内涨0.78%;COMEX黄金期货主力最新报3264.60美元/盎司,日内涨1.13%。每日经济新闻",
32 "siteName": "腾讯网",
33 "siteIcon": "https://api.cn-hongkong.unifuncs.com/siteicon/6e6577732e71712e636f6d7c6131323961643465",
34 "datePublished": "2025-05-13T13:19:00+08:00"
35 },
36 {
37 "name": "5月13日上海港铬矿石价格行情-我的钢铁网",
38 "url": "https://ge.mysteel.com/gekuang/m/25051309/FDD8507513ACCFD8.html",
39 "displayUrl": "https://ge.mysteel.com/gekuang/m/25051309/FDD8507513ACCFD8.html",
40 "snippet": "品名\n品位\n产地\n最低价\n最高价\n中间价\n涨跌\n备注\n当前筛选\n铬精粉\n40-42%\n南非\n散货价,铬铁比1.3min\n铬精粉\n42-44%\n南非\n散货价,铬铁比1.45min\n铬籽矿\n36-38%\n",
41 "summary": "品名\n品位\n产地\n最低价\n最高价\n中间价\n涨跌\n备注\n当前筛选\n铬精粉\n40-42%\n南非\n散货价,铬铁比1.3min\n铬精粉\n42-44%\n南非\n散货价,铬铁比1.45min\n铬籽矿\n36-38%\n南非\n散货价\n铬籽矿\n38-40%\n南非\n散货价\n铬原矿\n36-38%\n南非\n散货价,铬铁比1.35-1.4\n铬原矿\n38-40%\n南非\n散货价,铬铁比1.45\n铬块矿\n30-32%\n阿曼\n集装箱价格,铬铁比1.8\n铬块矿\n36-38%\n南非\n散货价\n铬块矿\n38-40%\n南非\n散货价\n铬块矿\n40-42%\n伊朗\n集装箱价格\n铬块矿\n40-42%\n巴基斯坦\n集装箱价格\n铬块矿\n40-42%\n阿尔巴尼亚\n集装箱价格\n备注:\n1.价格单位:元/干吨度\n2.交易方式:以人民币结算的信用证交易\n3.产品品位:Cr2O3含量\n4.港口现货价格为港口堆场汽车车板交货价\n资讯采集:齐翔\n021-26090025\n资讯监督:严娜\n021-26093004\n资讯投诉:陈跃进\n021-26093100\n免责声明:Mysteel力求使用的信息准确、信息所述内容及观点的客观公正,但并不保证其是否需要进行必要变更。Mysteel提供的信息仅供客户决策参考,并不构成对客户决策的直接建议,客户不应以此取代自己的独立判断,客户做出的任何决策与Mysteel无关。本报告版权归Mysteel所有,为非公开资料,仅供Mysteel客户自身使用;本文为Mysteel编辑,如需使用,请联系021-26093490申请授权,未经Mysteel书面授权,任何人不得以任何形式传播、发布、复制本报告。Mysteel保留对任何侵权行为和有悖报告原意的引用行为进行追究的权利。",
42 "siteName": "ge.mysteel.com",
43 "siteIcon": "https://api.cn-hongkong.unifuncs.com/siteicon/67652e6d79737465656c2e636f6d7c3934643361636432",
44 "datePublished": "2025-05-13T09:13:00+08:00"
45 },
46 {
47 "name": "All Financial Events in Indonesia (May 2025)",
48 "url": "https://10times.com/indonesia/finance?month=may",
49 "displayUrl": "https://10times.com/indonesia/finance?month=may",
50 "snippet": "Sign in to unlock all features Save Filter With multiple categories and locations Calendar 01 - 31 M",
51 "summary": "Sign in to unlock all features Save Filter With multiple categories and locations Calendar 01 - 31 May 2025 Select Date 01 - 31 May 2025 Today Tomorrow This Weekend This Week Next Week Next 3 Months December, 2024 30 December, 2024 (30) January, 2025 (54) February, 2025 (20) March, 2025 (4) April, 2025 (9) May, 2025 (6) June, 2025 (2) July, 2025 August, 2025 September, 2025 October, 2025 (1) November, 2025 View More Format Trade Shows, Conferences, ... Location Near Me Bali Area 615 Jakarta 274 Kuta",
52 "siteName": "10times.com",
53 "siteIcon": "https://api.cn-hongkong.unifuncs.com/siteicon/313074696d65732e636f6d7c6364613566306665",
54 "datePublished": "2025-05-13T05:47:29+08:00"
55 }
56 ],
57 "images": []
58 },
59 "requestId": "b835fd3b-feba-40bb-8129-e06a489fa805"
60}
响应字段说明
字段 | 类型 | 描述 |
---|---|---|
code | number | 状态码 查看状态码说明 |
message | string | 状态消息 |
data.webPages | array | 网页搜索结果数组 |
data.webPages[].name | string | 网页标题 |
data.webPages[].url | string | 网页URL |
data.webPages[].displayUrl | string | 显示用的URL |
data.webPages[].snippet | string | 网页内容片段 |
data.webPages[].summary | string | 网页内容摘要(当summary参数为true时返回) |
data.webPages[].siteName | string | 网站名称 |
data.webPages[].siteIcon | string | 网站图标URL |
data.images | array | 图片搜索结果数组 |
data.images[].thumbnailUrl | string | 图片缩略图URL |
data.images[].contentUrl | string | 原始图片URL |
data.images[].width | number | 图片宽度 |
data.images[].height | number | 图片高度 |
data.images[].hostPageUrl | string | 图片所在页面URL |
data.images[].hostPageDisplayUrl | string | 图片所在页面显示用URL |
requestId | string | 请求ID,用于追踪和调试 |
状态码和错误处理
状态码 | 消息 | 说明 |
---|---|---|
0 | 请求成功 | 返回正常的响应内容 |
-20001 | 服务器错误 | 联系客服确认原因或稍后再试 |
-20011 | 无权限访问 | 账户可能无权限访问该API |
-20014 | 账户被禁用 | 请联系客服确认账户禁用原因 |
-20021 | API Key无效或已过期 | 请检查API Key是否正确且有效 |
-20025 | 账户余额不足 | 请检查账户余额是否充足 |
-20033 | 请求超出速率限制 | 降低请求频率或联系UniFuncs提升您的用户级别 |
-30000 | 搜索失败 | 请联系客服确认失败原因 |
-30001 | 搜索关键词无效 | 请检查搜索关键词是否正确 |