search

跨域检索

实时Beta

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

一次搜索国内 10 类公开信源（微博、抖音、今日头条、小红书、快手等短视频、微信公众号、新闻网站与纸媒、论坛贴吧、B 站等长视频、新闻 APP），可按时间、平台、内容类型和情感筛选，返回统一格式的结果、命中总数和各平台分布。时间按北京时间的自然日计算，默认最近 7 天，最多 90 天。每页 10 或 20 条，最多翻到第 50 页。一次搜索通常需要几秒钟。没有结果时返回空结果，不计费。

常见用途：接入你的数据分析、监测或 AI Agent 工作流。

价格: $0.005 / 次$5 / 千次
计费: 成功且有结果才扣费扣费写在 meta.charged_usd
权限: searchAPI Key 需要这个 scope
限速: 不限流不按账户或接口限制每分钟请求数

请求参数

作为 JSON 请求体发送

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

querystring必填

搜索词。多个词用空格分开，表示同时包含，如「人工智能教育」；要排除的词放进 exclude_words

最多 200 字格式\S

示例人工智能

platformsstring[]

只搜这些平台，默认全部：weibo 微博、douyin 抖音、toutiao 今日头条、xiaohongshu 小红书、short_video 快手等短视频、wechat 微信公众号、news 新闻网站与纸媒、forum 论坛贴吧与问答、long_video B 站等长视频、app 新闻 APP

默认weibo, douyin, toutiao, xiaohongshu, short_video, wechat, news, forum, long_video, app可选值weibo · douyin · toutiao · xiaohongshu · short_video · wechat · news · forum · long_video · app

sincestring

起始日期 YYYY-MM-DD（北京时间，含当天），默认 until 往前 6 天

格式^[0-9]{4}-[0-9]{2}-[0-9]{2}$

untilstring

截止日期 YYYY-MM-DD（北京时间，含当天），默认今天，不能晚于今天；since 到 until 最多 90 天

格式^[0-9]{4}-[0-9]{2}-[0-9]{2}$

typesstring[]

内容类型，默认全部：original 原创、repost 转发、comment 评论

默认original, repost, comment可选值original · repost · comment

sentimentstring[]

情感倾向，默认全部：negative 负面、neutral 中性、positive 正面

默认negative, neutral, positive可选值negative · neutral · positive

matchstring[]

在哪里匹配搜索词，默认标题、正文和作者：title 标题、content 正文、author 作者名、media_text 图片和视频画面、audio 音频

默认title, content, author可选值title · content · author · media_text · audio

exclude_wordsstring

过滤词：含这些词的结果不返回

最多 100 字

authorstring

只看这个作者（账号名称）发布的内容

最多 50 字

pageinteger

页码，从 1 开始，最大 50

默认1范围1–50

limitinteger · enum

每页条数：10 或 20

默认20可选值10 · 20

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": {
    "items": [
      {
        "id": "soc_wei_e32e9c5a0c8f",
        "platform": "weibo",
        "site": "微博",
        "title": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”中国教育发展战略学会人工智能与机器人...",
        "original_title": null,
        "text": "“‘念PPT’其背后折射出的更多是教学态度、教学效果和课堂互动方面的问题。”中国教育发展战略学会人工智能与机器人教育专业…",
        "summary": null,
        "url": "http://weibo.com/1700648435/RnISydWJo",
        "published_at": "2026-10-21T19:31:06+08:00",
        "type": "original",
        "sentiment": "neutral",
        "author": {
          "name": "成都商报",
          "followers": 25329072,
          "following": 947,
          "description": "《成都商报》是西部地区发行量和影响力最大的主流媒体。互联网新闻信息服务许可证：51120180004。",
          "avatar": "https://tvax3.sinaimg.cn/crop.0.0.1000.1000.50/001R5Kltly8h8vghc7zenj60rs0rsjsz02.jpg?KID=imgbed,tva&Expires=1792593090&ssig=E8HZxs%2Frbc"
        },
        "ip_location": null,
        "location": "四川",
        "media": {
          "images": [],
          "videos": [
            "http://weibo.com/1700648435/RnISydWJo"
          ]
        },
        "repost_of": null,
        "metrics": {
          "likes": null,
          "comments": null,
          "shares": null,
          "views": 324,
          "saves": null
        }
      },
      {
        "id": "web_new_bf22c963ec0e",
        "platform": "news",
        "site": "懂车帝",
        "title": "*ST易录：2026年第三季度净利润亏损1.54亿元",
        "original_title": null,
        "text": "同花顺各类信息服务基于人工智能算法，如有出入请以证监会指定上市公司信息披露平台为准。如有投资者据此操作，风险自担，同花顺…",
        "summary": null,
        "url": "https://www.dongchedi.com/article/7699080505556107818/",
        "published_at": "2026-10-21T19:24:45+08:00",
        "type": "original",
        "sentiment": "negative",
        "author": {
          "name": "同花顺财经",
          "followers": 1334032,
          "following": 22,
          "description": "股票金融信息资讯专家",
          "avatar": "https://sf3-cdn-tos.toutiaostatic.com/img/user-avatar/2x_16286e5ac29b80d8e23428a6d5b72b9e~1080x1080.image"
        },
        "ip_location": "北京",
        "location": null,
        "media": {
          "images": [],
          "videos": []
        },
        "repost_of": null,
        "metrics": null
      }
    ],
    "total": 1966273,
    "by_platform": {
      "weibo": 119048,
      "douyin": 380189,
      "toutiao": 364539,
      "xiaohongshu": 52024,
      "short_video": 16111,
      "wechat": 234572,
      "news": 589995,
      "forum": 26994,
      "long_video": 9314,
      "app": 173500
    },
    "page": 1,
    "limit": 20,
    "has_more": true,
    "prov": {
      "hash": "0xb0ecb783f9c747ec",
      "ts": "2026-10-21T19:35:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.005000",
    "balance_usd": "9.995000",
    "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	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、数组超过允许的条数、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用，请先充值。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

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

全部错误码

在浏览器里直接调用

需要登录并充值；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key