Threads reactions API
パラメータは 2026-10-25 の仕様スナップショット、レスポンスの行は 2026-11-21 の実レスポンスで確認
要点
POST /threads/reactions/task に投稿 URL を指定すると、その投稿の reactions を収集する非同期タスクが始まります。GET /threads/reactions/task/{task_id} をポーリングすると、実行中はステータスと件数が返り、DONE になるとレスポンスに、投稿の view_count、like_count、share_count を持つ task オブジェクト、reactions の一覧 data(各行に LIKE などの type とリアクションしたアカウント)、pagination が含まれます。1 ページは最大 1000 行です。ポーリング時に mask_author=true を指定すると、レスポンスから投稿者の識別フィールドを除けます。データは Threads で公開されているコンテンツをウェブクローラーで収集したものです。
主な用途
- 1 件の投稿の閲覧数・いいね数・シェア数を 1 つのタスクで把握する。
- キーワード検索で見つけた複数の投稿について、reactions の量を比較する。
- 件数と種類だけが必要な場合に、投稿者フィールドを伏せて reactions を収集する。
エンドポイント
Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。
| メソッド | パス | 説明 |
|---|---|---|
| POST | /threads/reactions/task |
投稿 URL から reactions の収集タスクを作成します。rerun は既定で true です。 |
| GET | /threads/reactions/task/{task_id} |
reactions タスクをポーリングします。成功時は reactions 一覧とページ情報を返します。 |
リクエストパラメータ
POST /threads/reactions/task
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
post_url |
body | string | はい | reactions を取得したい Threads の投稿 URL。 | |
mask_author |
body | boolean | — | false |
true にすると、このレスポンスから投稿者の識別フィールドを除きます。返される行を伏せるには、GET でポーリングするたびに指定します。 |
rerun |
body | boolean | — | true |
既定は true。同じ post_url を再送すると新しいタスクになります。 |
GET /threads/reactions/task/{task_id}
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
task_id |
path | string | はい | タスク作成時に返されたタスク ID。 | |
mask_author |
query | boolean | — | false |
true にすると、このレスポンスから投稿者の識別フィールドを除きます。返される行を伏せるには、GET でポーリングするたびに指定します。 |
page |
query | integer | — | ページ番号(1 から)。 | |
per_page |
query | integer | — | 最大 1000 |
1 ページあたりの reactions 件数(最大 1000)。 |
レスポンスのフィールド
| データ | フィールド | エンドポイント |
|---|---|---|
| reactions | task: status, post_id, view_count, like_count, share_count, total, completed; data: id, post_id, type, author, author_id, updated_at; pagination: page, per_page, total_count, total_pages, has_next, has_prev; error_message | GET /threads/reactions/task/{task_id} |
コード例
curl:タスクを作成
curl -X POST https://api.infominer.io/api/v2/threads/reactions/task \
-H "auth-header: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"post_url": "https://www.threads.com/@sample_user_1/post/00000000001", "mask_author": false}'
curl:タスク ID でポーリング
curl "https://api.infominer.io/api/v2/threads/reactions/task/$TASK_ID?page=1&per_page=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}/threads/reactions/task",
headers=HEADERS,
json={
"post_url": "https://www.threads.com/@sample_user_1/post/00000000001",
"mask_author": False,
},
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}/threads/reactions/task/{task['id']}",
headers=HEADERS,
params={
"page": 1,
"per_page": 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 / per_page to fetch further pages)
if result.get("error_message"):
raise SystemExit(result["error_message"])
for row in result.get("data", []):
print(row.get("type"), row.get("author"))
レスポンス例
手作業で作成したサンプルデータです。アカウントは sample_user_n、ID は明らかなダミー値です。フィールド名は 2026-11-21 に確認した実際の API レスポンスに基づき、一部のフィールドのみを示しています。
タスク完了後のポーリングレスポンス(サンプルデータ)
{
"task": {
"id": "00000000-0000-4000-8000-000000000001",
"status": "DONE",
"post_url": "https://www.threads.com/@sample_user_1/post/00000000001",
"post_id": "0000000000000000001",
"view_count": 1250,
"like_count": 2,
"share_count": 1,
"total": 2,
"completed": 2,
"partial": false,
"timed_out": false,
"failed_articles": 0,
"failed_pages": 0
},
"data": [
{
"id": "00000000-0000-4000-8000-000000000007",
"post_id": "0000000000000000001",
"type": "LIKE",
"author": "sample_user_3",
"author_id": "0000000003",
"updated_at": 1781143200
},
{
"id": "00000000-0000-4000-8000-000000000008",
"post_id": "0000000000000000001",
"type": "LIKE",
"author": "sample_user_4",
"author_id": "0000000004",
"updated_at": 1781143200
}
],
"pagination": {
"page": 1,
"per_page": 1000,
"total_count": 2,
"total_pages": 1,
"has_next": false,
"has_prev": false
}
}
制限と注意点
- per_page は最大 1000 です。
- reactions レスポンスの post_id は Threads の数値の投稿 ID で、検索やタイムラインの行が post_id として返す URL 内のコードとは異なります。対応付けには post_url を使います。
- rerun は既定で true のため、同じ post_url を再送すると新しいタスクになります。
- タスクは成功したが一覧を取得できなかった場合、レスポンスに error_message が含まれます。
- 1 投稿あたりの件数と更新頻度はプロジェクトの範囲に応じて確認します。
ほかの Threads API ページ
- キーワード検索
- 返信
- ユーザータイムライン
- reactions
トライアルの申し込み
下の申込フォームに Threads と明記し、キーワードやアカウント、返信と reactions の要否、投稿者フィールドを伏せる必要があるかをお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。
フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。
申込フォームに記入するよくある質問
- reactions タスクはどの件数を返しますか?
- task オブジェクトが投稿の view_count、like_count、share_count を返し、pagination.total_count が reactions の行数を示します。
- reactions をページ送りするには?
- GET リクエストで page と per_page を指定します。per_page は最大 1000 で、pagination に has_next と total_pages が返ります。
- リアクションしたアカウントの情報を除けますか?
- はい。GET でポーリングするたびに mask_author=true を指定すると、そのレスポンスから投稿者の識別フィールドが除かれます。
- データはどのように収集していますか?Threads の公式 API ですか?
- Threads で公開されているコンテンツをウェブクローラーで収集しています。当社は Meta および Threads と提携しておらず、Meta が提供する Threads API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。