微博關鍵字搜尋 API

依 2026-10-25 規格快照

快速解答

POST /weibo/search/task 會以單一關鍵字建立非同步任務,爬取微博的搜尋結果,可選用 start_date、end_date 與 max_pages 限定範圍。以 GET /weibo/search/task/{task_id} 輪詢;狀態為 DONE 時,同一個回應帶回貼文與 total_count,每頁最多 100 筆。在示意樣本中,每則貼文有網址、作者、內文、時間戳記、中繼資料標籤、情感標籤,以及按讚數、留言數與分享數。資料以網路爬蟲蒐集微博公開發布的內容。

常見用途

  • 追蹤微博使用者如何討論某個品牌、產品類別或競爭對手,並取出討論量突增背後的貼文。
  • 為市場研究或學術研究建立某一主題的貼文資料集,每則附日期,並可用互動數排序。
  • 把貼文網址交給留言與轉發端點,觀察單則貼文獲得的回應與擴散情形。

端點一覽

Base URL 為 https://api.infominer.io/api/v2,每個請求以 auth-header 標頭帶 API 金鑰。

方法路徑說明
POST /weibo/search/task 建立關鍵字搜尋任務,可指定日期區間與最多爬取頁數。
GET /weibo/search/task/{task_id} 輪詢搜尋任務;DONE 時同時回傳貼文與 total_count,可分頁。

請求參數

POST /weibo/search/task

參數位置型別必填預設值/可用值說明
keyword body string 是 搜尋關鍵字。
end_date body string 否 晚於此日期的貼文不蒐集(YYYY-MM-DD)。
max_pages body integer 否 最多爬取的結果頁數。
start_date body string 否 蒐集到早於此日期的貼文時停止(YYYY-MM-DD)。

GET /weibo/search/task/{task_id}

參數位置型別必填預設值/可用值說明
task_id path string 是 建立任務時回傳的任務 ID。
page query integer 否 1 頁碼,從 1 開始。
pageSize query integer 否 100 每頁貼文數,最多 100。

回應欄位

資料欄位端點
貼文(示意樣本) url, author, author_id, content, tm, datetime, metadata_tags, sentiment, like_count, comment_count, share_count GET /weibo/search/task/{task_id}

程式碼範例

curl:建立任務

curl -X POST https://api.infominer.io/api/v2/weibo/search/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "手冲咖啡", "start_date": "2026-06-01", "end_date": "2026-06-30", "max_pages": 3}'

curl:以任務 ID 輪詢

curl "https://api.infominer.io/api/v2/weibo/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}/weibo/search/task",
    headers=HEADERS,
    json={
        "keyword": "手冲咖啡",
        "start_date": "2026-06-01",
        "end_date": "2026-06-30",
        "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}/weibo/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")

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.get("url"), (row.get("content") or "")[:60])

示意回應樣本

以下為人工撰寫的示意資料:帳號為 sample_user_n,ID 為明顯的假值。欄位依 2026-10-25 規格快照;樣本只呈現部分欄位,完整清單見上方表格。

任務狀態為 DONE 後的輪詢回應(示意資料)

{
  "keyword": "手冲咖啡",
  "status": "DONE",
  "total_count": 2,
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "status": "DONE"
  },
  "data": [
    {
      "source": "weiboblog",
      "platform": "weibo",
      "url": "https://m.weibo.cn/detail/0000000000000001",
      "author": "sample_user_1",
      "author_id": "0000000000000001",
      "content": "周末在巷子里的咖啡店试了新豆子,酸度很柔和,推荐给喜欢浅焙的朋友 #手冲咖啡",
      "tm": 1781056800,
      "datetime": "2026-06-10 10:00:00",
      "type": [],
      "metadata_tags": [
        "手冲咖啡"
      ],
      "sentiment": "Positive",
      "like_count": 12,
      "comment_count": 3,
      "share_count": 1
    },
    {
      "source": "weiboblog",
      "platform": "weibo",
      "url": "https://m.weibo.cn/detail/0000000000000002",
      "author": "sample_user_2",
      "author_id": "0000000000000002",
      "content": "整理了三间适合下午工作的咖啡店,插座和座位都在文末清单",
      "tm": 1781060400,
      "datetime": "2026-06-10 11:00:00",
      "type": [],
      "metadata_tags": [
        "咖啡店",
        "下午茶"
      ],
      "sentiment": "Neutral",
      "like_count": 5,
      "comment_count": 0,
      "share_count": 0
    }
  ]
}

限制與注意事項

  • 搜尋結果每頁最多讀取 100 筆。
  • start_date 與 end_date 界定爬取範圍:蒐集到早於 start_date 的貼文時停止,晚於 end_date 的貼文不蒐集。
  • 搜尋可回溯的期間、每個任務的資料量與更新頻率,依專案範圍確認。
蒐集方式:以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。

更多 微博 API 頁面

申請試用

填寫下方申請表單時,請註明微博,並說明要追的關鍵字(中文或英文訂閱)、是否需要留言、轉發與轉發鏈,以及預估資料量。我們會確認範圍,並回覆試用與 API 金鑰的安排。

填寫表單申請試用,專人確認範圍後回覆試用與介接安排。

填寫申請表單

常見問題

可以用英文關鍵字搜尋微博嗎?
微博貼文多以簡體中文撰寫,因此關鍵字通常以中文指定。若團隊以英文作業,微博英譯訂閱會把英文關鍵字轉成中文檢索詞,並回傳附英文機器翻譯的貼文。
一個搜尋任務會回傳多少則貼文?
max_pages 限制最多爬取的結果頁數;每個任務的資料量依專案範圍確認。結果以 page 與 pageSize 讀取,每頁最多 100 筆。
任務失敗時該怎麼處理?
持續輪詢,直到狀態不再是 INIT 或 RUNNING。DONE 時讀取資料;FAILED 時停止並處理失敗,例如重新建立任務。
資料是怎麼蒐集的?這是微博官方的 API 嗎?
資料以網路爬蟲蒐集微博公開發布的內容。LargitData 與微博沒有隸屬或合作關係,這也不是微博自身提供的 API。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。