抖音留言 API
依 2026-10-25 規格快照
快速解答
以影片網址呼叫 POST /douyin/pushs/task,會建立非同步任務,蒐集該支影片的留言:預設 50 則,可用 max_items 設定上限(0 或負數代表不設則數上限),或以 get_all=true 取消預設上限。以 GET /douyin/pushs/task/{task_id} 輪詢;任務完成後回傳該影片已儲存的留言(可能含先前蒐集的留言),每頁最多 1000 筆。輪詢時可用 order_type=hot 或 time 指定讀取排序。每則留言以 post_id 指回所屬影片。不提供第二層回覆。資料以網路爬蟲蒐集抖音公開發布的內容。
常見用途
- 了解觀眾對產品影片、廣告或創作者合作內容的回應。
- 蒐集觀眾對某個產品類別的提問與疑慮。
- 比較關鍵字搜尋結果中排名在前的影片的留言情感。
端點一覽
Base URL 為 https://api.infominer.io/api/v2,每個請求以 auth-header 標頭帶 API 金鑰。
| 方法 | 路徑 | 說明 |
|---|---|---|
| POST | /douyin/pushs/task |
以影片網址建立留言任務,預設 50 則,可用 max_items 或 get_all 調整。 |
| GET | /douyin/pushs/task/{task_id} |
取回影片已儲存的留言,每頁最多 1000 筆,可指定 hot 或 time 排序。 |
請求參數
POST /douyin/pushs/task
| 參數 | 位置 | 型別 | 必填 | 預設值/可用值 | 說明 |
|---|---|---|---|---|---|
post_url |
body | string | 是 | 抖音影片網址。 | |
crawl_second_layer |
body | boolean | 否 | false |
只支援 false;不提供第二層回覆。 |
get_all |
body | boolean | 否 | false |
取消預設 50 則的上限。明確指定 max_items 時以其為準。 |
max_items |
body | integer | 否 | 50 |
最多蒐集的留言數;0 或負數代表不設則數上限。 |
order_type |
body | string | 否 | 預設 hot; 可用值 hot |
只接受 hot:讀取時依按讚數排序已儲存的留言,不影響蒐集的內容。 |
GET /douyin/pushs/task/{task_id}
| 參數 | 位置 | 型別 | 必填 | 預設值/可用值 | 說明 |
|---|---|---|---|---|---|
task_id |
path | string | 是 | 建立任務時回傳的任務 ID。 | |
order_type |
query | string | 否 | 可用值 hot | time |
選填的讀取排序:hot(按讚數由高到低)或 time(由新到舊)。省略時沿用建立任務時儲存的排序。 |
page |
query | integer | 否 | 1 |
頁碼,從 1 開始。 |
pageSize |
query | integer | 否 | 1000 |
每頁留言數,最多 1000。 |
回應欄位
| 資料 | 欄位 | 端點 |
|---|---|---|
| 留言 | id, post_id, author, author_id, content, push_type, sentiment, tm, tm_crawler, region | GET /douyin/pushs/task/{task_id} |
程式碼範例
curl:建立任務
curl -X POST https://api.infominer.io/api/v2/douyin/pushs/task \
-H "auth-header: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"post_url": "https://www.douyin.com/video/0000000000000001", "max_items": 500}'
curl:以任務 ID 輪詢
curl "https://api.infominer.io/api/v2/douyin/pushs/task/$TASK_ID?page=1&pageSize=1000&order_type=time" \
-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}/douyin/pushs/task",
headers=HEADERS,
json={
"post_url": "https://www.douyin.com/video/0000000000000001",
"max_items": 500,
},
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}/douyin/pushs/task/{task['id']}",
headers=HEADERS,
params={
"page": 1,
"pageSize": 1000,
"order_type": "time",
},
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"
}
]
}
限制與注意事項
- 留言預設每支影片 50 則。明確指定 max_items 時以其為準,get_all=true 會取消預設上限,但蒐集仍受分頁安全上限與來源可取得性限制;未完整蒐集時會標示 partial=true。
- order_type=hot 在讀取時依按讚數由高到低排序已儲存的留言,不保證蒐集到的留言就是平台上最多讚的留言。
- total_count 可能包含同一支影片先前蒐集的留言。
- crawl_second_layer 只接受 false:不提供第二層回覆。
- 留言每頁最多讀取 1000 筆。
蒐集方式:以網路爬蟲蒐集各平台公開發布的內容。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。
更多 抖音 API 頁面
申請試用
填寫下方申請表單時,請註明抖音,並說明要搜尋的關鍵字或帳號、每支影片需要的留言量,以及是否需要影片下載網址。我們會確認範圍,並回覆試用與 API 金鑰的安排。
填寫表單申請試用,專人確認範圍後回覆試用與介接安排。
填寫申請表單常見問題
- 每支抖音影片可以蒐集多少則留言?
- 預設 50 則。可用 max_items 設定其他上限,或以 get_all=true 取消預設上限;仍受分頁安全上限與來源可取得性限制。
- 可以取得抖音留言底下的回覆嗎?
- 目前不行:crawl_second_layer 只接受 false。
- post_url 接受哪一種網址格式?
- 完整的影片網址,例如 https://www.douyin.com/video/{id},與規格中的範例相同。影片網址解析(POST /douyin/videos)不接受 v.douyin.com 短網址。
- 資料是怎麼蒐集的?這是抖音官方的 API 嗎?
- 資料以網路爬蟲蒐集抖音公開發布的內容。LargitData 與抖音沒有隸屬或合作關係,這也不是抖音自身提供的 API。是否適用於您的用途,依用途與法域由買方法務評估,我們可提供來源與蒐集方式說明。