search

Cross-domain search

LiveBeta

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

One search across 10 kinds of public sources in China (Weibo, Douyin, Toutiao, Xiaohongshu, Kuaishou and other short-video apps, WeChat official accounts, news sites and newspapers, forums and Tieba, Bilibili and other long-video sites, news apps), filtered by date, platform, content type and sentiment. Returns the results in one format, with the total hit count and the count per platform. Dates are whole days in Beijing time: the last 7 days by default, at most 90. 10 or 20 results per page, up to page 50. A search usually takes a few seconds. No results answers empty and is not charged.

Typical uses: Feeding your analytics, monitoring or AI-agent workflows.

Price: $0.005 / call$5 per 1k
Billing: Charged only for successful, non-empty resultsthe charge is in meta.charged_usd
Scope: searchThe API key needs this scope
Rate limit: NoneNo per-account or per-endpoint request limit

Parameters

Sent as a JSON body

Only these parameters are accepted; any other one returns 400.

querystringRequired

What to search for. Separate terms with spaces to require all of them, as in 人工智能教育; put words to leave out in exclude_words

Max 200 charsPattern\S

Example人工智能

platformsstring[]

Only these platforms, all by default: weibo, douyin, toutiao, xiaohongshu, short_video (Kuaishou and other short-video apps), wechat (official accounts), news (news sites and newspapers), forum (forums, Tieba and Q&A sites), long_video (Bilibili and other long-video sites), app (news apps)

Defaultweibo, douyin, toutiao, xiaohongshu, short_video, wechat, news, forum, long_video, appOne ofweibo · douyin · toutiao · xiaohongshu · short_video · wechat · news · forum · long_video · app

sincestring

First day, YYYY-MM-DD (Beijing time, included); defaults to 6 days before until

Pattern^[0-9]{4}-[0-9]{2}-[0-9]{2}$

untilstring

Last day, YYYY-MM-DD (Beijing time, included); defaults to today and cannot be later. since to until spans at most 90 days

Pattern^[0-9]{4}-[0-9]{2}-[0-9]{2}$

typesstring[]

Content types, all by default: original, repost, comment

Defaultoriginal, repost, commentOne oforiginal · repost · comment

sentimentstring[]

Sentiment, all by default: negative, neutral, positive

Defaultnegative, neutral, positiveOne ofnegative · neutral · positive

matchstring[]

Where the search terms must match, title, content and author by default: title, content, author (author name), media_text (images and video frames), audio

Defaulttitle, content, authorOne oftitle · content · author · media_text · audio

exclude_wordsstring

Filter words; results that contain them are left out

Max 100 chars

authorstring

Only content published by this author (account name)

Max 50 chars

pageinteger

Page number, from 1, at most 50

Default1Range1–50

limitinteger · enum

Results per page: 10 or 20

Default20One of10 · 20

curl https://api.qovia.ai/v1/search \
  -H "Authorization: Bearer $QOVIA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"人工智能"}'

Replace $QOVIA_KEY with your API key

Example response200 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
  }
}

Catalog sample, not live data

Response

A success is HTTP 200 with the shared envelope: request_id, data (this endpoint's data, see the example) and meta (the charge). An empty result is also 200, with meta.empty true, not charged, and data may be an empty structure or null.

The response envelope in detail

Errors

Errors this endpoint can return
code	HTTP	Billing	Description
`scope_denied`	403	Not charged	This API key lacks the scope the endpoint requires.
`endpoint_unavailable`	503	Not charged	The endpoint is not available right now (no data source connected yet, or no price configured); nothing ran.
`invalid_params`	400	Not charged	The parameters failed validation: a required one is missing, a type or format is wrong, an array has more items than allowed, an unknown one was sent, or the POST body is not a JSON object. An error in one parameter starts with its name (`item_id: …`); a missing or unknown parameter starts with `params: …`.
`insufficient_balance`	402	Not charged	The balance cannot pay for this call; top up first.
`upstream_busy`Retryable	503	Refunded	The data source is busy or cooling down; refunded. Retry after `Retry-After`.
`upstream_timeout`	504	Refunded	The data source timed out; refunded.
`upstream_error`	502 / 503	Refunded	The data source failed; refunded.
`upstream_rejected`	400	Refunded	The data source rejected these parameters (well-formed, but not accepted); refunded.
`not_found`	404	Refunded	The data source has no such item (deleted, or the ID does not exist); refunded.
`reservation_expired`	504	Refunded	The call took too long and was refunded automatically; no data is returned.

Any request can also fail authentication: 401 invalid_api_key, 403 account_disabled, 429 too_many_auth_failures.

Every error code

Call it from your browser

Needs an account with a balance; playground calls are billed like API calls.

Try in the playground Create an API key