中Get startedTop up
Get startedTop upSign in / Sign upConsole
中EN
Weibo

Weibo API

Read posts, comments, user profiles, keyword search and the hot search list from Weibo over REST: 7 live endpoints, one API key and one JSON envelope. Below are all of them and a real request and response.

Get 50 trial callsAPI reference

A new account gets 50 trial calls; after that, successful calls are billed from a prepaid balance. See pricing.

7 Weibo API endpoints

Parameters, response fields and code samples for each are in the API reference.

A request and its response

Weibo search（GET /v1/raw/weibo/search). The sample comes from the endpoint catalog, not live data; a full response also carries request_id and meta.

cURL
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"
data in the 200 OK response
{
  "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"
    }
  }
}

Use Weibo data from an AI tool

Qovia is also an MCP server. Run this in Claude Code. Finding and reading endpoints needs no key; to call them, set up your API key as in the MCP docs. Cursor and VS Code setups are there too.

Shell
claude mcp add --transport http qovia https://api.qovia.ai/mcp

FAQ

How do I call the Weibo API?

Send a GET request to https://api.qovia.ai, for example /v1/raw/weibo/…, with your API key in an Authorization: Bearer header. A success is HTTP 200 with request_id, data and meta. This page lists all 7 endpoints, and each one's parameters are in the API reference.

Does Weibo have an official data API?

Weibo's open platform needs a registered app and user authorization, and public data such as keyword search across Weibo or the comments on any post is generally out of reach for ordinary developers. Qovia serves that public data through one API key.

What Weibo data can I get?

Single posts (full text, author, like/comment/repost counts, views and video plays where Weibo shows them, topics, images, publish time and IP location), comments and replies, user profiles and their posts, keyword search (with a date range and filters such as hot, original or verified users) and the hot search list.

How much can Weibo search return?

Up to about 20 posts a page, up to 50 pages. Text in search results can be truncated and carries no engagement counts; for the full text and like, comment and repost counts, call the post endpoint with the post's ID.

Do I need a Weibo account or cookies?

No. All you need is a Qovia API key: no accounts, cookies, proxies or request signing to maintain.

How is it billed?

Prepaid and per call: only successful calls that return data are charged, and empty results, errors and timeouts are not. Every response says what it cost (meta.charged_usd). Each endpoint's price is in the API reference.

Can I use it from Claude, Cursor or other AI tools?

Yes. Qovia is also an MCP server (https://api.qovia.ai/mcp): add it to Claude Code, Cursor or VS Code with your API key and the AI finds the endpoint, pulls the data and summarises it.

What should I keep in mind when using the data?

Qovia provides a data API service and claims no ownership of the underlying content. Use the data under applicable law and Weibo's platform rules; see our terms of service.

Your agent only knows what you give it

Give it Douyin, Xiaohongshu (RedNote), WeChat and product reviews: structured, per call, nothing charged for failures.

Get an API keyContact us