百度貼吧(Baidu Tieba)スレッド検索 API

2026-11-21 時点の仕様に基づく

要点

POST /tieba/search/task は、キーワードと投稿日の期間(YYYY-MM-DD、UTC+8、当日を含む。既定は直近 7 日)で貼吧のスレッドを新しい順に検索し、期間内の各スレッドについて 1 階の全文、返信数といいね数、掲示板(吧)の名前、投稿者の IP 所在地も収集します。max_pages は 0〜31(0 または省略で 31)、1 ページ 20 スレッドで、1 回の検索で約 620 スレッドまでです。ページ全体が start_date より古くなった時点でタスクは早めに終了します。GET /tieba/search/task/{task_id} でポーリングし、DONE になるとレスポンスに task、total_count、data が含まれます(1 ページ最大 100 件)。データは百度貼吧で公開されているコンテンツをウェブクローラーで収集したものです。

主な用途

  • 製品、ブランド、地域の話題について貼吧の掲示板で何が語られているかを追う。
  • 研究のためにテーマごとのスレッドを日付付きで集め、返信数で活発なものを見つける。
  • スレッドの URL を貼吧の返信 API に渡し、フロア(スレッド内の各投稿)とフロア内の返信を読む。

エンドポイント

Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。

メソッドパス説明
POST /tieba/search/task スレッドのキーワード検索タスクを作成します。期間とページ上限を指定できます。
GET /tieba/search/task/{task_id} 検索タスクをポーリングします。DONE でスレッドと total_count を返します(1 ページ最大 100 件)。

リクエストパラメータ

POST /tieba/search/task

パラメータ位置型必須既定値/指定可能な値説明
keyword body string はい 検索キーワード(1〜100 文字)。
end_date body string — 終了日(当日を含む、YYYY-MM-DD、UTC+8)。既定は当日。
max_pages body integer — 31(最大 31) 検索結果ページ数の上限。0 または省略で既定値。1 ページ 20 スレッド。
rerun body boolean — ほかのプラットフォームとの互換のために受け付けます。POST するたびに新しいタスクが作成されます。
start_date body string — 開始日(当日を含む、YYYY-MM-DD、UTC+8)。既定は 7 日前。

GET /tieba/search/task/{task_id}

パラメータ位置型必須既定値/指定可能な値説明
task_id path string はい タスク作成時に返されたタスク ID。
page query integer — 1 ページ番号(1 から)。
pageSize query integer — 100 1 ページあたりのスレッド数(最大 100)。

レスポンスのフィールド

データフィールドエンドポイント
スレッド(data) id, url, title, content, tm, datetime, tm_crawler, tm_update, author, author_id, type, ctype, source, sentiment, region, comment_count, like_count, share_count, metadata_img, metadata_videos GET /tieba/search/task/{task_id}
検索タスク(task) task: id, keyword, status, start_date, end_date, max_pages, created_at, total, completed, pages_crawled, partial, timed_out, failed_pages, failed_articles, failed_ranges, deleted, depth_capped GET /tieba/search/task/{task_id}

コード例

curl:タスクを作成

curl -X POST https://api.infominer.io/api/v2/tieba/search/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "公路车", "start_date": "2026-06-01", "end_date": "2026-06-07", "max_pages": 3}'

curl:タスク ID でポーリング

curl "https://api.infominer.io/api/v2/tieba/search/task/$TASK_ID?page=1&pageSize=100" \
  -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}/tieba/search/task",
    headers=HEADERS,
    json={
        "keyword": "公路车",
        "start_date": "2026-06-01",
        "end_date": "2026-06-07",
        "max_pages": 3,
    },
    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}/tieba/search/task/{task['id']}",
        headers=HEADERS,
        params={
            "page": 1,
            "pageSize": 100,
        },
        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")

task = result.get("task", result)
if status != "DONE" or task.get("partial") or task.get("timed_out"):
    raise SystemExit(f"task ended with status {status}; no complete result")

# 3. Read the records (use page / pageSize to fetch further pages)
for row in result.get("data", []):
    print(row.get("url"), (row.get("title") or "")[:60])

レスポンス例

手作業で作成したサンプルデータです。アカウントは sample_user_n、ID は明らかなダミー値です。フィールドは 2026-11-21 時点の仕様に基づき、一部のフィールドのみを示しています。

タスクが DONE になった後のポーリングレスポンス(サンプルデータ)

{
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "keyword": "公路车",
    "status": "DONE",
    "start_date": "2026-06-01",
    "end_date": "2026-06-07",
    "max_pages": 3,
    "created_at": 1780880400,
    "total": 2,
    "completed": 2,
    "pages_crawled": 1,
    "deleted": 0,
    "depth_capped": false,
    "timed_out": false,
    "partial": false,
    "failed_pages": 0,
    "failed_articles": 0,
    "failed_ranges": 0
  },
  "total_count": 2,
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000001",
      "url": "https://tieba.baidu.com/p/10000000001",
      "title": "入门公路车预算五千,大家帮忙看看这两款",
      "content": "平时通勤加周末骑行,身高 175,主要在两款之间犹豫,想听听吧友的意见",
      "tm": 1780666200,
      "datetime": "2026-06-05 21:30:00",
      "tm_crawler": 1780880404,
      "tm_update": 1780880404,
      "author": "sample_user_1",
      "author_id": "0000000001",
      "type": [
        "骑行"
      ],
      "ctype": [
        "骑行"
      ],
      "source": "tieba",
      "sentiment": "Neutral",
      "region": "江苏",
      "comment_count": 3,
      "like_count": 5,
      "share_count": 0,
      "metadata_img": [],
      "metadata_videos": []
    },
    {
      "id": "00000000-0000-4000-8000-000000000002",
      "url": "https://tieba.baidu.com/p/10000000002",
      "title": "公路车周末环湖骑行记录,风景很好",
      "content": "公路车周末环湖骑行记录,风景很好",
      "tm": 1780452000,
      "datetime": "2026-06-03 10:00:00",
      "tm_crawler": 1780880408,
      "tm_update": 1780880408,
      "author": "sample_user_2",
      "author_id": "0000000002",
      "type": [
        "骑行"
      ],
      "ctype": [
        "骑行"
      ],
      "source": "tieba",
      "sentiment": "Positive",
      "region": "浙江",
      "comment_count": 8,
      "like_count": 12,
      "share_count": 1,
      "metadata_img": [
        "https://tiebapic.baidu.com/forum/pic/item/sample_1.jpg"
      ],
      "metadata_videos": []
    }
  ],
  "page": 1,
  "pageSize": 100
}

制限と注意点

  • 1 回の検索で届くのは最大約 31 ページ、約 620 スレッドです。期間の古い側まで届かなかった場合は depth_capped が true になるので、期間を細かく分けてください。
  • 検索の対象はスレッドのタイトルと 1 階のみです。キーワードが返信にしか出てこないスレッドは一覧に出ず、一覧に出ても本文にキーワードがそのまま含まれないスレッドは data に入らないことがあります。
  • deleted は、一覧に出たものの収集時点で削除・非表示になっていたスレッドの数で、失敗ではありません。
  • データを含むのは DONE のポーリングだけで、PARTIAL、TIMED_OUT、FAILED はタスクオブジェクトのみを返します。status が DONE で partial と timed_out がともに false の場合を完全な成功として扱ってください。
  • data は以前のタスクの結果を含め、その期間に収集済みのデータに一致するものを返すため、total_count が task.completed を上回ることがあります。このタスクで収集した件数は task.completed です。
  • 数値は収集時点のもので、自動では更新されません。遡れる期間はプロジェクトの範囲に応じて確認します。
収集方法:各プラットフォームで公開されているコンテンツをウェブクローラーで収集しています。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。

ほかの 百度貼吧(Baidu Tieba) API ページ

トライアルの申し込み

下の申込フォームに百度貼吧と明記し、追いたいキーワード、掲示板(吧)やスレッド、フロアと返信の要否、想定データ量をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。

フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。

申込フォームに記入する

よくある質問

depth_capped は何を意味しますか?
期間の始まりに届く前に貼吧の検索ページが尽き、期間の古い側まで届かなかったことを示します。期間を細かく分けてタスクを作成してください。
スレッドがどの掲示板のものかはわかりますか?
type と ctype に掲示板(吧)の名前が入ります。スレッドの URL は https://tieba.baidu.com/p/{スレッド ID} です。
貼吧の検索は返信の中も対象ですか?
いいえ。対象はスレッドのタイトルと 1 階のみです。
データはどのように収集していますか?百度貼吧の公式 API ですか?
百度貼吧で公開されているコンテンツをウェブクローラーで収集しています。当社は百度貼吧と提携しておらず、百度貼吧自身が提供する API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。