微博搜索博文

POST🔗 /api/weibo/search-v1🔒 需开通

微博搜索

🔒

该接口需开通后调用暂未开放自助调用。联系销售为你的账号开通权限并发放调用 token。

按关键词搜索微博博文列表。

请求参数

参数名	类型	必填	默认值	说明
token	string	是	-	你的访问令牌（通过 query 传递）
keyword	string	是	-	搜索关键词
page	number	否	1	页码

代码示例

环境地址：示例中的 https://<your_endpoint> 为占位符，请替换为客服为你分配的专属接入地址（详见快速开始）。

cURL

curl -X POST 'https://<your_endpoint>/api/weibo/search-v1?token=YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"世界杯","page":1}'

Python

import requests

resp = requests.post(
    "https://<your_endpoint>/api/weibo/search-v1",
    params={"token": "YOUR_TOKEN"},
    json={
      "keyword": "世界杯",
      "page": 1
    },
    timeout=60,
)
print(resp.json())

Node.js

const resp = await fetch('https://<your_endpoint>/api/weibo/search-v1?token=YOUR_TOKEN', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"keyword":"世界杯","page":1}),
})
console.log(await resp.json())

响应结果示例

成功响应

{
  "code": 0,
  "message": "ok",
  "data": {
    "keyword": "世界杯",
    "total": 560000,
    "list": [
      {
        "mid": "M_1",
        "text": "示例微博",
        "reposts": 12,
        "attitudes": 320
      }
    ]
  }
}

错误响应

{
  "code": 303,
  "message": "采集失败，请稍后重试",
  "data": null
}