智能搜索

智能搜索

0次调用
4 积分/次

想在你的应用中集成搜索功能?这个接口可以帮你轻松实现实时网页搜索。

POST
uapis.cn
/api/v1/search/aggregate
Body
query
string
required

搜索查询关键词,支持中英文

site
string

限制搜索特定网站,不需要 site: 前缀

filetype
string

限制文件类型,不需要 filetype: 前缀。支持 pdf、doc、docx、ppt、pptx、xls、xlsx、txt 等

fetch_full
boolean

是否获取页面完整正文(会影响响应时间)

sort
string

排序方式

time_range
string

时间范围过滤

功能概述

UAPI Pro Search 可以根据查询内容返回更相关的搜索结果。你可以用它搜索任何关键词,也可以限定在特定网站或特定文件类型中搜索。

  • 实时网页搜索: 毫秒级响应,快速返回搜索结果
  • 智能排序: 根据查询内容返回更相关的结果
  • 时间排序: 支持按发布时间排序,获取最新内容
  • 时间范围过滤: 支持按天/周/月/年过滤结果
  • 站内搜索: 支持 site: 操作符,在指定网站内搜索
  • 文件类型过滤: 支持 filetype: 操作符,快速找到 PDF、Word 等特定格式文件

请求体

query
string必填

搜索查询关键词,支持中英文

site
string可选

限制搜索特定网站,不需要 site: 前缀

filetype
string可选

限制文件类型,不需要 filetype: 前缀。支持 pdf、doc、docx、ppt、pptx、xls、xlsx、txt 等

fetch_full
boolean可选

是否获取页面完整正文(会影响响应时间)

sort
string可选

排序方式

time_range
string可选

时间范围过滤

响应

200 / 请求成功

搜索成功,返回经过智能排序的搜索结果、本次命中的搜索源信息和请求元数据

JSON
{
  // 执行的搜索查询
  "query": "Go最新的版本是多少",
  // 返回的搜索结果总数
  "total_results": 15,
  // 搜索结果列表
  "results": [
    {
      // 结果标题
      "title": "Go 1.26 正式发布",
      // 结果链接
      "url": "https://go.dev/blog/go1.26",
      // 结果摘要/描述
      "snippet": "2026年2月10日,Go 团队正式发布了 Go 1.26 版本。",
      // 来源域名
      "domain": "go.dev",
      "source": "uapi-searchv1",
      // 原始排名位置
      "position": 1,
      // 综合得分(0-1,已经过排序)
      "score": 0.93,
      // 发布时间(ISO 8601 格式)
      "publish_time": "2026-02-10T00:00:00Z"
    }
  ],
  // 本次请求实际命中的搜索引擎信息
  "sources": [
    {
      // 搜索引擎版本
      "name": "uapi-searchv1",
      // 本次搜索引擎调用状态
      "status": "success",
      // 该搜索引擎返回的结果数
      "result_count": 15,
      // 该搜索引擎的耗时(毫秒)
      "elapsed_ms": 3675,
      // 该搜索源首条结果的域名
      "first_result_host": "go.dev"
    }
  ],
  // 本次请求总耗时(毫秒)
  "process_time_ms": 3675,
  // 本次请求的处理元数据
  "metadata": {
    // 服务端实际生效的请求参数回显
    "request_params": {
      // 实际执行的搜索词
      "query": "Go最新的版本是多少",
      // 实际生效的返回条数
      "limit": 10,
      // 实际生效的页码
      "page": 1,
      // 实际生效的超时时间(毫秒)
      "timeout_ms": 60000,
      // 实际生效的排序方式
      "sort": "relevance"
    },
    // 去重后移除的结果数
    "dedupe_removed": 0,
    // 是否执行了排序重排
    "rerank_applied": true,
    // 额外抓取正文的结果数
    "content_fetched": 0
  }
}

400 / 错误的请求

请求参数错误

JSON
{
  "code": "INVALID_REQUEST",
  "message": "请求参数格式错误"
}

401 / 未经授权

未授权

JSON
{
  "code": "UNAUTHORIZED",
  "message": "无效的访问令牌"
}

429 / 请求过于频繁

请求过于频繁

JSON
{
  "code": "RATE_LIMIT_EXCEEDED",
  "message": "请求过于频繁,请稍后重试"
}

500 / 服务器内部错误

服务器内部错误

JSON
{
  "code": "INTERNAL_ERROR",
  "message": "服务器内部错误"
}