search

跨域检索

即将上线Beta可用免费额度

POSThttps://api.qovia.ai/v1/search

一次查询同时检索社交、电商、网页三个领域，语义 + 关键词混合，返回统一格式、向量和来源证明。

上线后价格: $0.004 / 次$4 / 千次每月超过 100 万次后 $3 / 千次每月超过 1,000 万次后 $2.5 / 千次
计费: 成功且有结果才扣费优先用免费额度
权限: searchAPI Key 需要这个 scope
限速: 全局 100 次/秒所有用户合计，另有账户每分钟上限

即将上线

参数和返回格式已经确定，但还没有接入数据源。现在调用会收到 503 endpoint_unavailable，不会扣费。

请求参数

作为 JSON 请求体发送

只接受下列参数，多出的参数会返回 400。

querystring必填

检索内容

最多 500 字

示例通勤咖啡测评

domainsstring[]

限定领域：social 社交、ecommerce 电商、web 网页

默认social, ecommerce, web可选值social · ecommerce · web

platformsstring[]

限定平台 slug

freshnessstring

1h–90d

默认24h格式^[0-9]+(h|d)$

formatenum

返回格式：records 只返回记录，vectors+provenance 附带向量和来源证明

默认vectors+provenance可选值records · vectors+provenance

limitinteger

返回条数

默认20范围1–100

curl https://api.qovia.ai/v1/search \
  -H "Authorization: Bearer $QOVIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"通勤咖啡测评"}'

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": [
    {
      "id": "soc_xia_5c8a",
      "src": "social",
      "platform": "xiaohongshu",
      "lang": "zh-CN",
      "text": "早八人通勤咖啡测评｜这三家真的值",
      "author": {
        "uid_hash": "7be2a1",
        "followers": 56900
      },
      "metrics": {
        "likes": 3204,
        "comments": 517,
        "saves": 1188
      },
      "prov": {
        "hash": "0xf491d8d1",
        "ts": "2026-07-04T09:12:41+08:00"
      }
    }
  ],
  "meta": {
    "billed": true,
    "charged_usd": "0.004000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.996000",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码