raw.weibo.search

微博搜索

实时Beta不使用免费额度

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

按关键词搜索微博，可限定发布日期范围（北京时间，按天），可只看热门、原创、认证用户、媒体或观点，可只看含图片、视频、音乐或链接的微博；记录与微博详情相同（同一 id），正文可能被截断（extra.truncated），互动数不提供。每页条数不固定（最多约 20 条），按 page 翻页，最多 50 页，返回空结果时停止。没有结果时返回空结果，不计费。

价格: $0.001 / 次$1 / 千次 · 固定价格
计费: 成功且有结果才扣费不使用免费额度
权限: raw:weiboAPI Key 需要这个 scope
限速: 仅账户限流账户每分钟上限

请求参数

作为查询参数发送

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

keywordstring必填

搜索关键词

最多 100 字格式\S

示例长征

start_datestring

发布日期起（含当天，北京时间，YYYY-MM-DD）；与 end_date 一起传

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

示例2026-10-20

end_datestring

发布日期止（含当天，北京时间，YYYY-MM-DD）；与 start_date 一起传

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

示例2026-10-21

typestring · enum

只看：all 全部、hot 热门、original 原创、verified 认证用户、media 媒体、viewpoint 观点；不传为全部

可选值all · hot · original · verified · media · viewpoint

containsstring · enum

包含：all 不限、image 图片、video 视频、music 音乐、link 链接；不传为不限

可选值all · image · video · music · link

pageinteger

页码，从 1 开始，最大 50

默认1范围1–50

传 start_date 时必须同时传 end_date
传 end_date 时必须同时传 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"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 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
  }
}

目录示例，不是实时数据

响应

成功返回 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: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`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