Threads ユーザータイムライン API
パラメータは 2026-10-25 の仕様スナップショット、レスポンスの行は 2026-11-21 の実レスポンスで確認
要点
POST /threads/users/task に author_id(Threads のユーザー名。先頭の @ は任意)と、任意の start_date、end_date を指定すると、その公開アカウントの投稿を収集する非同期タスクが始まります。GET /threads/users/task/{task_id} をポーリングすると、投稿が data に、件数が total_count に返ります。各投稿には URL、ネイティブの投稿 ID、本文、タイムスタンプ、いいね・返信・シェアの件数、メディア URL が含まれます。データは Threads で公開されているコンテンツをウェブクローラーで収集したものです。
主な用途
- ブランド、メディア、機関の公式アカウントが一定期間に何を投稿したかを追う。
- 研究のために、公開アカウントの投稿を日付付きで記録する。
- 同じ期間で複数アカウントの投稿頻度とエンゲージメントを比較する。
エンドポイント
Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。
| メソッド | パス | 説明 |
|---|---|---|
| POST | /threads/users/task |
公開アカウントの投稿タイムラインのタスクを作成します。期間を指定できます。 |
| GET | /threads/users/task/{task_id} |
タイムラインタスクのステータスと件数、およびそのアカウントの投稿(data)を返します。 |
リクエストパラメータ
POST /threads/users/task
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
author_id |
body | string | はい | 公開アカウントの Threads ユーザー名。先頭の @ は任意です。 | |
end_date |
body | string | — | 期間の終了日(当日を含む、YYYY-MM-DD)。start_date がない場合は無視されます。 | |
mask_author |
body | boolean | — | false |
true にすると、このレスポンスから投稿者の識別フィールドを除きます。返される行を伏せるには、GET でポーリングするたびに指定します。 |
max_scroll |
body | integer | — | クロール時のスクロール上限(整数)。 | |
rerun |
body | boolean | — | 真偽値。収集をやり直します。 | |
start_date |
body | string | — | 期間の開始日(当日を含む、YYYY-MM-DD)。 |
GET /threads/users/task/{task_id}
| パラメータ | 位置 | 型 | 必須 | 既定値/指定可能な値 | 説明 |
|---|---|---|---|---|---|
task_id |
path | string | はい | タスク作成時に返されたタスク ID。 | |
mask_author |
query | boolean | — | false |
true にすると、このレスポンスから投稿者の識別フィールドを除きます。返される行を伏せるには、GET でポーリングするたびに指定します。 |
レスポンスのフィールド
| データ | フィールド | エンドポイント |
|---|---|---|
| 公開アカウントの投稿 | id, post_id, url, author, author_id, author_name, content, tm, tm_crawler, like_count, reaction_count, comment_count, share_count, is_reply, is_quote, metadata_img, metadata_videos, tag, source | GET /threads/users/task/{task_id} |
コード例
curl:タスクを作成
curl -X POST https://api.infominer.io/api/v2/threads/users/task \
-H "auth-header: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"author_id": "sample_user_1", "start_date": "2026-06-01", "end_date": "2026-06-30"}'
curl:タスク ID でポーリング
curl "https://api.infominer.io/api/v2/threads/users/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/users/task",
headers=HEADERS,
json={
"author_id": "sample_user_1",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
},
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/users/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)
for row in result.get("data", []):
print(row.get("url"), (row.get("content") or "")[:60])
レスポンス例
手作業で作成したサンプルデータです。アカウントは sample_user_n、ID は明らかなダミー値です。フィールド名は 2026-11-21 に確認した実際の API レスポンスに基づき、一部のフィールドのみを示しています。
タスク完了後のポーリングレスポンス(サンプルデータ)
{
"id": "00000000-0000-4000-8000-000000000001",
"status": "DONE",
"author_id": "sample_user_1",
"start_date": "2026-06-01",
"end_date": "2026-06-30",
"total": 2,
"completed": 2,
"partial": false,
"timed_out": false,
"failed_articles": 0,
"failed_pages": 0,
"total_count": 2,
"data": [
{
"id": "00000000-0000-4000-8000-000000000003",
"source": "threads",
"post_id": "00000000001",
"url": "https://www.threads.com/@sample_user_1/post/00000000001",
"author": "sample_user_1",
"author_id": "0000000001",
"content": "週末走了一條不太熱門的步道,沿途視野很開闊,建議早點出發避開人潮",
"tm": 1781056800,
"tm_crawler": 1781143200,
"like_count": 34,
"reaction_count": 34,
"comment_count": 2,
"share_count": 1,
"is_reply": false,
"is_quote": false,
"metadata_img": [],
"metadata_videos": [],
"tag": ""
},
{
"id": "00000000-0000-4000-8000-000000000006",
"source": "threads",
"post_id": "00000000004",
"url": "https://www.threads.com/@sample_user_1/post/00000000004",
"author": "sample_user_1",
"author_id": "0000000001",
"content": "整理了這個月走過的三條步道,交通方式和所需時間都寫在清單裡",
"tm": 1781229600,
"tm_crawler": 1781316000,
"like_count": 12,
"reaction_count": 12,
"comment_count": 0,
"share_count": 2,
"is_reply": false,
"is_quote": false,
"metadata_img": [],
"metadata_videos": [],
"tag": ""
}
]
}
制限と注意点
- author_id は必須です。start_date と end_date は任意で、当日を含みます。
- ポーリングレスポンスはページ単位で返ります。GET リクエストで page と per_page を指定します(per_page は既定値・上限とも 1000)。レスポンスには page、per_page と、その時点までの総件数 total_count が示されるので、total_count 件に達するまで次のページを読み取ってください。
- start_date なしで end_date だけを指定すると、上流側はその指定を無視して既定の期間を適用します。
- 収集するのは Threads で公開されているコンテンツのみです。
- 遡れる期間と更新頻度はプロジェクトの範囲に応じて確認します。
ほかの Threads API ページ
トライアルの申し込み
下の申込フォームに Threads と明記し、キーワードやアカウント、返信と reactions の要否、投稿者フィールドを伏せる必要があるかをお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。
フォームにご記入のうえ、トライアルをお申し込みください。担当者が範囲を確認のうえ、トライアルと連携の進め方をご返信します。
申込フォームに記入するよくある質問
- author_id には何を指定しますか?
- アカウントの Threads ユーザー名です。先頭の @ はあってもなくても構いません。
- 非公開アカウントの投稿は収集できますか?
- いいえ。収集するのは Threads で公開されているコンテンツのみです。
- タイムラインに各投稿への返信は含まれますか?
- タイムラインタスクが収集するのはアカウントの投稿です。投稿への返信を収集するには、その投稿の URL で返信タスクを作成します。
- データはどのように収集していますか?Threads の公式 API ですか?
- Threads で公開されているコンテンツをウェブクローラーで収集しています。当社は Meta および Threads と提携しておらず、Meta が提供する Threads API ではありません。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。