raw.weibo.search

Weibo search

LiveBetaNo free quota

GEThttps://api.qovia.ai/v1/raw/weibo/search

Keyword search for Weibo posts, optionally within a range of publish dates (Beijing time, whole days), only hot, original, verified-user, media or viewpoint posts, or only posts with images, videos, music or links; the same records as post detail (same ids), with text that may be cut (extra.truncated) and no interaction counts. Pages hold a varying number of posts (up to about 20); page by number, up to 50 pages, and stop at an empty page. No results answers empty and is not charged.

Price: $0.001 / call$1 per 1k · fixed price
Billing: Charged only for successful, non-empty resultsno free quota
Scope: raw:weiboThe API key needs this scope
Rate cap: Account limit onlyYour per-minute limit

Parameters

Sent as query parameters

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

keywordstringRequired

Search keyword

Max 100 charsPattern\S

Example长征

start_datestring

First publish date, included (Beijing time, YYYY-MM-DD); pass it with end_date

Pattern^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$

Example2026-10-20

end_datestring

Last publish date, included (Beijing time, YYYY-MM-DD); pass it with start_date

Pattern^20[0-9]{2}-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])$

Example2026-10-21

typestring · enum

Only: all, hot, original, verified (verified users), media or viewpoint; all when left out

One ofall · hot · original · verified · media · viewpoint

containsstring · enum

Containing: all, image, video, music or link; all when left out

One ofall · image · video · music · link

pageinteger

Page number, from 1, at most 50

Default1Range1–50

start_date requires end_date
end_date requires start_date

curl 'https://api.qovia.ai/v1/raw/weibo/search?keyword=%E9%95%BF%E5%BE%81&start_date=2026-10-20&end_date=2026-10-21' \
  -H "Authorization: Bearer $QOVIA_KEY"

Replace $QOVIA_KEY with your API key

Example response200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "id": "soc_wei_66be530dfcd9",
        "src": "social",
        "platform": "weibo",
        "lang": "zh-CN",
        "text": "【#活动散场后男子吹响冲锋号全场沸腾#】近日，天津一场长征胜利90周年纪念活动散场后，一名男子吹响冲锋号，瞬间全场沸腾。该男子接受中新网采访时表示，当时散场后大家说再吹一个，于是就贴合主题吹了冲锋号。中国新闻网的微博视频（中国新闻网）",
        "author": {
          "uid_hash": "f879ebcea33e",
          "followers": null,
          "nickname": "工人日报",
          "uid": "3840768703"
        },
        "metrics": {
          "likes": null,
          "comments": null,
          "shares": null
        },
        "extra": {
          "source_id": "5356593191060572",
          "mblogid": "RnKfl4rU0",
          "published_at": "2026-10-21T23:00:00+08:00",
          "content_type": "video",
          "topic": "#活动散场后男子吹响冲锋号全场沸腾",
          "topics": [
            "活动散场后男子吹响冲锋号全场沸腾"
          ],
          "images": [],
          "cover_url": null,
          "video_dur_s": null,
          "ip_location": null,
          "truncated": false,
          "repost_of": null,
          "url": "https://weibo.com/3840768703/RnKfl4rU0"
        },
        "prov": {
          "hash": "0xdc59f6580c0f1192",
          "ts": "2026-10-21T23:50:00+08:00",
          "source": "live"
        }
      },
      {
        "id": "soc_wei_efafe027096e",
        "src": "social",
        "platform": "weibo",
        "lang": "zh-CN",
        "text": "#晚安，广西！#【#周深献唱纪念红军长征胜利90周年MV#】九十年长风不息，烽烟虽远，星火滚烫。@卡布叻_周深倾情演唱的《万里长风》，以歌声回望来路，循先辈足迹，奔赴属于我们的新征程。#跨越90年的回信#（来源：央视新闻）央视新闻的微博视频",
        "author": {
          "uid_hash": "8a692ede06c2",
          "followers": null,
          "nickname": "广西新闻网",
          "uid": "1986954045"
        },
        "metrics": {
          "likes": null,
          "comments": null,
          "shares": null
        },
        "extra": {
          "source_id": "5356593190540232",
          "mblogid": "RnKfl2gxq",
          "published_at": "2026-10-21T23:00:00+08:00",
          "content_type": "video",
          "topic": "#晚安，广西！",
          "topics": [
            "晚安，广西！",
            "周深献唱纪念红军长征胜利90周年MV",
            "跨越90年的回信"
          ],
          "images": [],
          "cover_url": null,
          "video_dur_s": null,
          "ip_location": null,
          "truncated": false,
          "repost_of": null,
          "url": "https://weibo.com/1986954045/RnKfl2gxq"
        },
        "prov": {
          "hash": "0xd5cc0da71c4fbd32",
          "ts": "2026-10-21T23:50:00+08:00",
          "source": "live"
        }
      }
    ],
    "page": 1,
    "has_more": true,
    "prov": {
      "hash": "0x0454d79596c740cd",
      "ts": "2026-10-21T23:50:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.999000",
    "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 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: …`.
`rate_limited`Retryable	429	Not charged	Over the account's per-minute limit (sliding 60-second window); wait for `Retry-After`.
`too_many_unbilled`Retryable	429	Not charged	In the last 10 minutes at least 50 of your calls to data sources, and over 80% of them, came back empty, not found or rejected; slow down.
`insufficient_balance`	402	Not charged	The balance cannot pay for this call (the free quota is used up, or the endpoint does not use it).
`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; playground calls are billed like API calls.

Try in the playground Create an API key