Documentation

API 参考

核心端点。所有响应为统一 schema，字段说明见数据示例。

快速开始API 参考MCP Integration

POST /v1/search

L1 实时检索：语义 + 关键词，一次命中三域。

Request bodyapplication/json
{
  "query": "string",           // 必填
  "domains": ["social","ecommerce","web"],
  "freshness": "24h",        // 1h–90d
  "format": "vectors+provenance",
  "limit": 20               // ≤100
}
RESPONSE TIME 821MS · STATUS 200application/json
{
  "id": "soc_xia_ea4a…",
  "src": "social",
  "platform": "xiaohongshu",
  "lang": "zh-CN",
  "text": "早八人通勤咖啡测评｜这三家真的值",
  "author": {
    "uid_hash": "7be2…",
    "followers": 56900
  },
  "metrics": {
    "likes": 3204,
    "comments": 517,
    "saves": 1188
  },
  "comment_thread": [
    "第二家我也天天喝",
    "求地址！"
  ],
  "extra": {
    "note_type": "image",
    "topic": "#咖啡测评"
  },
  "vec": "[1536 dims]",
  "prov": {
    "hash": "0x0b9749fe",
    "ts": "2026-07-04T09:12:41+08:00"
  }
}

GET /v1/raw/{platform}/{resource}

L1 原始端点：平台原生结构（评论树 / 创作者图谱 / 价格轨迹），platform 取值见站点目录。

Examplecurl
curl "https://api.qovia.ai/v1/raw/douyin/comments?item_id=…&cursor=0" \
  -H "Authorization: Bearer $QOVIA_KEY"

GET /v1/datasets/slices

L2 数据集切片：按 domain × platform × language × time-window 过滤，返回可下载的静态语料清单。

错误码

Code含义计费
400参数错误否
401API key 无效否
402额度不足否
429触发限流否
200成功且 payload 非空是