API ・ MCP
Threadsの公開データを、あなたのAgentとプロダクトに。
投稿検索、キーワードトレンド、人気ランキング、アカウントとフォロワー履歴。MCPでClaude・ChatGPT・Cursorに、RESTで自社サービスに接続できます。すべての回答に、確かめられる数字が付きます。
AGENT 実況
Agentはこのデータをどう使う？
実際の問いを投げて、Agentが自らツールを呼び、データを読み、根拠のある提案を返すまで。下はサンプルの会話です。
mcp · throk
サンプルデータ
「転職」というテーマ、まだ伸びしろある？
⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts
まだ上昇中です。「転職」の直近7日間の投稿数は3.1倍に増加。しかも5万いいね超えの天井投稿はまだ出ていません：
6/07
6/09
6/11
6/13
切り口の提案：「辞めました」ではなく「残った人はどう思っているか」を書く。高エンゲージメントのリプライの38%はまだ辞めていない様子見層からで、この層は代弁者を探しています。
接続方法
MCP か REST
AgentにはMCP、サービスにはREST。
02 · REST API
REST API
またはRESTを直接叩く
THREADS API 料金
月額US$30から。月間クレジットで選べます。
4プランすべてで全データエンドポイントとMCPを利用でき、Standard以上でWebhookも使えます。Throk MCPとREST APIは同じ開発者クレジットを使います。
答えられること
AI AgentはThrokで何を調べられる？
先に判断したいことを決め、必要なThreadsデータを選びます。ツール名と制限は技術資料にまとめています。
- 01
テーマと需要を探す
投稿、意味の近いコンテンツ、キーワード量を検索。
- 02
競合とアカウントを見る
最近の投稿、人気投稿、フォロワー変化を確認。
- 03
トレンドとタイミングをつかむ
人気・成長ランキングと投稿時間帯を確認。
19ツールと検索制限を見る＋
全ツール一覧
19のツール、1つのキー
キーワード・セマンティック検索、人気・急上昇ランキング、神リプライやフォロワー増加から、ゴールデンタイムのヒートマップ、フォロワー・いいねのパーセンタイル、ユーザープロフィール、フォロワー履歴、ライブ数値とバズ予測まで。
| ツール | 返すもの | 上限 |
|---|---|---|
| search_posts | キーワードで公開投稿を検索 | 25 件 / 回 |
| get_inspiration | 反応の多い厳選投稿からアイデアを探す | 10 件 |
| semantic_search_posts | 直近30日の投稿をセマンティック検索 | 10 件 |
| get_hot_posts | 人気投稿ランキング | 50 件 |
| get_keyword_trend | キーワードの日次ボリューム | 10 語 × 90 日 |
| get_post_like_growth | 急上昇投稿ランキング | 50 件 |
| get_cool_replies | 神リプライランキング | 50 件 |
| get_follower_growth | フォロワー急増ランキング | 50 件 |
| get_power_hours | ゴールデンタイムのヒートマップ | 直近 28 日 |
| get_follower_ladder | フォロワー数パーセンタイル | パーセンタイル |
| get_like_ladder | いいね数パーセンタイル | 直近 24 時間 |
| get_user | ユーザープロフィールと最近の投稿 | 各 25 件 |
| get_user_top_threads | ユーザーのいいね上位投稿 | 最長 720 日 |
| get_user_follower_history | フォロワー数履歴 | 最長 365 日 |
| get_user_interactions | アカウントが最もよく交流している相手 | 最大100件・90日 |
| forecast_posts | バズ予測：48時間後の閲覧数と到達確率 | 10 件 / 回、投稿後 1〜12 時間 |
| get_live_posts | 投稿のライブ数値と画像 | 10 件 / 回 |
| get_live_users | アカウントのライブフォロワー数とプロフィール | 10 件 / 回 |
| get_balance | 残りクレジットを照会 | 無料 |
作れるもの
つなげたら、こんなものが作れます
どれも既存のツールとエンドポイントだけで作れます。
広報のエゴサーチ自動化
get_keyword_trend でブランド名の言及数を毎日取得し、しきい値を超えた投稿は Webhook から n8n 経由で Slack へ。
SNS運用代行の月次レポート
get_user とフォロワー履歴を定期的に呼び出し、クライアントごとのレポートを自動で作成。
インフルエンサー選定
フォロワー数パーセンタイルで規模を測り、よく交流している相手からその人の輪を確認。
AIライター
Claude でまず人気投稿と神リプライを調べ、そのデータをもとに下書きさせる。
よくある質問
- APIのクレジットはThrokのサブスクと同じですか？
- いいえ。開発者プラットフォームには独立したAPIプランとクレジットがあり、ウェブ版のFree／Creator／Creator+サブスクとは完全に別建てで、相互に利用できません。開発者コンソールで別途契約が必要です。
- Throk API と Meta 公式の Threads API はどう違いますか？
- Meta 公式の Threads API は、投稿の公開や自分のアカウントの管理に使うもので、Meta のアプリ審査が必要です。Throk API は Threads の公開データを調べるためのもので、投稿検索、キーワードトレンド、人気ランキング、どの公開アカウントのフォロワー推移も取得できます。用途が異なるので、併用もできます。
- 無料枠はありますか？料金は？
- プランは月間クレジット数で分かれ、API Lite（月15,000クレジット）からPremium（月6,000,000クレジット）まで、開発者プラットフォームで購入できます。残高・利用履歴の確認とWebhookのテストイベントはクレジットを消費しません。
- クレジットの有効期限は？
- クレジットは購入日から1か月間有効で、未使用分は翌期に繰り越されません。もっと必要なときは、上位プランへのアップグレードのほか、プランのレート（API Standard US$10／Plus US$5／Premium US$4・10,000 クレジットあたり）で買い切りの追加購入もできます。追加分は今の請求サイクル終了時にリセットされます。
- MCPとREST、どちらを使う？対応クライアントは？
- AIエージェントに使わせるならMCP。Claude、ChatGPT、Codex、Cursorなどに対応し、コマンド1行で接続できます。自分のサービスから直接呼ぶならREST。すべての機能は両方でカバーされます。
- データの範囲は？
- Threads公開投稿の検索、人気ランキング、キーワードトレンド、ユーザープロフィール、フォロワー履歴をカバーします。投稿は投稿者の所在地ではなく、投稿そのものの言語で分類されます。呼び出しごとに language パラメータで1言語を指定します：zh＝中国語（すべて）、zh-Hant＝繁体字中国語、zh-Hans＝簡体字中国語、yue＝広東語、en＝英語、ja＝日本語、ko＝韓国語。省略時は zh になるため、日本語・韓国語・英語の投稿は明示的に指定してください。複数の言語を比べるときは言語ごとに呼び出します。検索・トレンド・ランキング・パーセンタイルのエンドポイントはすべて7言語に対応し、Webhookのルールは中国語・日本語・韓国語の投稿に対応しています。
- どう始めれば？
- developer.throk.aiで登録してAPIキーを発行し、プランを選べば呼び出しを始められます。MCPはキーなしでThrokアカウントにログインして接続することもできます。
あなたのAgentに、Threadsを調べさせよう。
開発者プラットフォームでプランを選び、キーを発行します。MCPならThrokアカウントでそのままログインもできます。