Weibo(微博)コメント API
2026-10-25 時点の仕様スナップショットに基づく
要点
POST /weibo/pushs/task に投稿 URL を指定すると、その投稿のコメントを収集する非同期タスクが作成されます。order_type は hot、time、both から選べ、crawl_second_layer=true で第 2 階層の返信も収集し、get_all=true で重複チェックをオフにしてすべてのコメントを収集します。GET /weibo/pushs/task/{task_id} でポーリングし、DONE になるとコメントと total_count を 1 ページ最大 1000 件で返します。各コメントは post_id で元の投稿にひも付き、投稿者、本文、感情ラベル、時刻を持ちます。データはWeiboで公開されているコンテンツをウェブクローラーで収集したものです。
主な用途
- ブランドの発表、新製品、ニュース投稿に対して、読者がどう反応したかを見る。
- 同じテーマの複数の投稿について、コメントの感情ラベルを比較する。
- リポスト API と組み合わせ、返信した人と拡散した人を分けて把握する。
エンドポイント
Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。
| メソッド | パス | 説明 |
|---|---|---|
| POST | /weibo/pushs/task |
投稿 URL からコメント収集タスクを作成します。並び順と第 2 階層の返信を指定できます。 |
| GET | /weibo/pushs/task/{task_id} |
コメントタスクをポーリングします。DONE になるとコメントを 1 ページ最大 1000 件で返します。 |
リクエストパラメータ
POST /weibo/pushs/task
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
post_url |
body | string | はい | Weiboの投稿 URL(例:https://m.weibo.cn/detail/{id})。 | |
crawl_second_layer |
body | boolean | — | false |
第 2 階層の返信も収集します。 |
get_all |
body | boolean | — | false |
重複チェックをオフにし、すべてのコメントを収集します。 |
order_type |
body | string | — | 既定 hot; 指定可 hot | time | both |
コメントの並び順。 |
GET /weibo/pushs/task/{task_id}
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
task_id |
path | string | はい | タスク作成時に返されたタスク ID。 | |
page |
query | integer | — | 1 |
ページ番号(1 から)。 |
pageSize |
query | integer | — | 1000 |
1 ページあたりのコメント数(最大 1000)。 |
レスポンスのフィールド
| データ | フィールド | エンドポイント |
|---|---|---|
| コメント | id, post_id, author, author_id, content, push_type, sentiment, tm, tm_crawler, region | GET /weibo/pushs/task/{task_id} |
コード例
curl:タスクを作成
curl -X POST https://api.infominer.io/api/v2/weibo/pushs/task \
-H "auth-header: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"post_url": "https://m.weibo.cn/detail/0000000000000001", "order_type": "time", "crawl_second_layer": true}'
curl:タスク ID でポーリング
curl "https://api.infominer.io/api/v2/weibo/pushs/task/$TASK_ID?page=1&pageSize=1000" \
-H "auth-header: YOUR_API_KEY"
Python(requests):作成・ポーリング・読み取り
import time
import requests
BASE_URL = "https://api.infominer.io/api/v2"
HEADERS = {"auth-header": "YOUR_API_KEY"}
# 1. Create the task
resp = requests.post(
f"{BASE_URL}/weibo/pushs/task",
headers=HEADERS,
json={
"post_url": "https://m.weibo.cn/detail/0000000000000001",
"order_type": "time",
"crawl_second_layer": True,
},
timeout=30,
)
resp.raise_for_status()
task = resp.json()
# 2. Poll until the task leaves INIT / RUNNING
for _ in range(120):
resp = requests.get(
f"{BASE_URL}/weibo/pushs/task/{task['id']}",
headers=HEADERS,
params={
"page": 1,
"pageSize": 1000,
},
timeout=30,
)
resp.raise_for_status()
result = resp.json()
status = result.get("status") or result.get("task", {}).get("status")
if status not in ("INIT", "RUNNING"):
break
time.sleep(15)
else:
raise SystemExit("task still running; poll it again later")
if status == "FAILED":
raise SystemExit("task failed")
if status != "DONE":
print("task ended with status", status, "- results may be incomplete")
# 3. Read the records (use page / pageSize to fetch further pages)
for row in result.get("data", []):
print(row["post_id"], row["author"], row["content"][:60])
レスポンス例
手作業で作成したサンプルデータです。アカウントは sample_user_n、ID は明らかなダミー値です。フィールドは 2026-10-25 の仕様スナップショットに基づき、サンプルはその一部のみを示しています(全項目は上の表を参照)。
タスクが DONE になった後のポーリングレスポンス(サンプルデータ)
{
"task": {
"id": "00000000-0000-4000-8000-000000000001",
"status": "DONE"
},
"total_count": 2,
"data": [
{
"id": "0000000000000101",
"post_id": "0000000000000001",
"author": "sample_user_3",
"author_id": "0000000000000003",
"tm": 1781065800,
"tm_crawler": 1781150400,
"content": "这家店的浅焙豆子确实不错,周末想去试试",
"sentiment": "Positive"
},
{
"id": "0000000000000102",
"post_id": "0000000000000001",
"author": "sample_user_4",
"author_id": "0000000000000004",
"tm": 1781067600,
"tm_crawler": 1781150400,
"content": "请问营业时间到几点?",
"sentiment": "Neutral"
}
]
}
制限と注意点
- コメントは 1 ページ最大 1000 件で読み取ります。
- crawl_second_layer の既定値は false です。第 2 階層の返信が必要な場合は true にします。
- コメントタスクは既定で重複チェックを行います。すべてのコメントを収集するには get_all を true にします。
- 投稿あたりの件数と更新頻度はプロジェクトの範囲に応じて確認します。
ほかの Weibo(微博) API ページ
- キーワード検索
- コメント
- リポストとリポスト連鎖
- ユーザータイムライン
- 英語翻訳
トライアルの申し込み
下の申込フォームに Weibo と明記し、追跡したいキーワード(中国語、または翻訳購読用の英語)、コメント・リポスト・リポスト連鎖の要否、想定データ量をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。
フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。
申込フォームに記入するよくある質問
- Weiboのコメントへの返信も取得できますか?
- コメントタスクの作成時に crawl_second_layer を true にしてください。既定値は false です。
- post_url にはどの形式の URL を指定しますか?
- 仕様の例ではモバイル版の投稿 URL(https://m.weibo.cn/detail/{id})を使っています。
- コメントと投稿はどう対応付けますか?
- すべてのコメントレコードに所属する投稿を指す post_id フィールドがあるため、複数タスクのコメントも投稿に結合できます。
- データはどのように収集していますか?Weiboの公式 API ですか?
- Weiboで公開されているコンテンツをウェブクローラーで収集しています。当社はWeiboと提携しておらず、Weibo自身が提供する API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。