SocQの最初のThreadsエンドポイントは、公開プロフィール、個別の投稿、ユーザーの投稿を読み取るものでした。2026-11-17には、さらに5つが公開されました。そのうち2つは検索で、キーワードやハッシュタグで投稿を探したり、名前でアカウントを探したりできます。残りの3つは会話と拡散を読み取るもので、投稿への返信、アカウントがほかの投稿に寄せた返信、そしてアカウントがリポストした投稿を取得できます。
このガイドでは、新しい各エンドポイントが返すデータ、リクエストの形、料金、使いどころを説明します。Meta公式のThreads APIやほかのプロバイダーとの比較については、Threads APIの代替サービスをご覧ください。
結論:
Authorization: Bearer $SOCQ_API_KEYを付けて、POST /v1/threads/searchまたは/search-usersにはqueryを、/post-replies、/user-replies、/user-repostsにはurlsにThreadsのURLを入れて送信します。statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングし、data.results.itemsを読み取ります。料金は結果1件あたり0.3〜0.6クレジット(1クレジット$0.005で換算すると$0.0015〜$0.003)で、基本料金はかかりません。
新しく追加された5つのThreadsエンドポイント
| エンドポイント | 返すデータ | 入力 | 料金 |
|---|---|---|---|
| Search | キーワードまたはハッシュタグの上位投稿(約20件)。テキスト、投稿者、いいね、返信、リポスト、メディア、日時を含む | query | 投稿1件あたり0.6クレジット($0.003) |
| User Search | 名前またはユーザー名に一致するアカウント(通常は最大10件)。表示名、アバター、認証ステータスを含む | query | アカウント1件あたり0.6クレジット($0.003) |
| Post Replies | 投稿への返信(投稿1件あたり約20件)。投稿者、いいね、返信、メディア、日時を含む | 投稿URL | 返信1件あたり0.3クレジット($0.0015) |
| User Replies | アカウントの最新の公開返信(最大約25件)。エンゲージメントとメディアを含む | プロフィールURL | 返信1件あたり0.5クレジット($0.0025) |
| User Reposts | アカウントが最近リポストした投稿(最大約25件)。それぞれに元の投稿者を含む | プロフィールURL | 投稿1件あたり0.5クレジット($0.0025) |
Threadsを検索する
Threads Search:キーワードやハッシュタグで投稿を探す
Threads Search APIは、アプリと同じ方法でThreadsを検索し、キーワードまたはハッシュタグの上位投稿を返します。各投稿には、テキスト、投稿者、いいね、返信、リポスト、メディア、公開日時が付きます。あるテーマ、製品、イベントがThreadsでどう語られているかを把握し、その会話をけん引しているアカウントを見つけるための、最も手早い方法です。
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "basketball"
}'
1回の検索で、そのクエリに対してThreadsが表示する上位投稿を約20件返します。エンゲージメントはmetricsの下のlikes_count、comments_count、shares_countに入ります。詳しくはSearchのドキュメントをご覧ください。
Threads User Search:名前でアカウントを探す
Threads User Search APIは、名前またはユーザー名でアカウントを検索します。一致した各アカウントについて、ユーザー名、表示名、プロフィールURL、アバター、認証ステータスを返します。投稿や返信を取得する前に正しいハンドルを確認したり、名前のリストをインフルエンサーリサーチ用のThreadsプロフィールに変換したりするのに使えます。
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "shams"
}'
1回の検索で、Threadsが提示するアカウントを通常は最大10件返します。詳しくはUser Searchのドキュメントをご覧ください。
会話とリポストを読み取る
Threads Post Replies:投稿に寄せられた会話
Threads Post Replies APIは、投稿に寄せられた会話を読み取ります。各返信には、テキスト、投稿者、いいね数と返信数、添付メディア、日時に加え、返信先の投稿のpost_idが含まれます。お知らせへの反応を測ったり、ブランドの投稿から顧客のフィードバックを集めたり、クリエイターのオーディエンスの中で特に熱心な人を見つけたりするのに使えます。
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
}'
投稿URLは/@{username}/post/{code}の形式で指定します。投稿ごとに、Threadsがその下に表示する返信を約20件返します。詳しくはPost Repliesのドキュメントをご覧ください。
Threads User Replies:アカウントがほかの人とどう話しているか
Threads User Replies APIは、アカウントの最新の公開返信を、テキスト、いいね、返信、メディア、日時、各返信へのリンクとともに返します。返信には、作り込まれた投稿よりも語り口や専門性が率直に表れるため、クリエイターの見極め、スポークスパーソンのモニタリング、ブランドが顧客との会話にどう対応しているかの調査に役立ちます。
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@reuters"]
}'
プロフィールURLはhttps://www.threads.com/@usernameのように指定します。プロフィールごとに最大約25件の返信を返します。詳しくはUser Repliesのドキュメントをご覧ください。
Threads User Reposts:アカウントが誰を拡散しているか
Threads User Reposts APIは、アカウントがリポストした投稿を返します。各行は元の投稿で、投稿者、テキスト、エンゲージメント、メディアが含まれます。リポスト履歴は親和性を直接示すシグナルです。クリエイターが信頼している発信者、ブランドが宣伝しているパートナー、コミュニティ内で広がっているコンテンツを把握できます。
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@shams"]
}'
プロフィールごとに最近のリポストを最大約25件返します。authorはリポストしたアカウントではなく、元の投稿者です。詳しくはUser Repostsのドキュメントをご覧ください。
シンプルなリサーチの流れ
- 製品名やハッシュタグでSearchを実行し、多くの反応を集めている投稿を見つけます。
- 特に反響の大きい投稿のURLをPost Repliesに渡し、反応を読み取ります。
- 話題に挙がった名前をUser Searchでハンドルに変換し、そのプロフィールに対してUser RepliesとUser Repostsを実行して、どのように話し、誰を拡散しているかを確認します。
- アカウント自身の投稿やプロフィールの詳細には、以前から提供しているUser PostsとProfilesのエンドポイントを使います。
認証と非同期タスクの流れ
すべてのリクエストには、APIキーとJSONのContent-Typeを付けます。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
送信リクエストごとに、バックグラウンドタスクが開始されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信時のレスポンスにはdata.task_idとdata.statusが含まれます。同じキーでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
タスクがqueued、running、failedの間、レスポンスにはタスクのメタデータのみが含まれます。failedの場合はerror_messageを確認してください。succeededになると、同じレスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueの場合は、results.next_cursorをcursorとして渡すと次のページを読み取れます。fieldsにはカンマ区切りで最大50個のフィールドまたはドットパスを指定できます。
クライアント側でタイムアウトしてもタスクはキャンセルされません。重複したタスクを送信して二重に支払うのではなく、同じtask_idで照会を再開してください。送信ボディにcallback_urlを追加すると、タスクの完了時にタスクの概要をPOSTで1回受け取ることもできます。
典型的なジョブの料金
- 1回のキーワード検索で20件の投稿を取得する:20 × 0.6 = 12クレジット、$0.06。
- 10件の投稿について、それぞれ約20件の返信を取得する:200 × 0.3 = 60クレジット、$0.30。
- 10アカウントについて、それぞれ約25件の返信とリポストを取得する:500 × 0.5 = 250クレジット、$1.25。
よくある質問(FAQ)
検索結果の最初の20件より先を取得できますか?
Searchは、そのクエリに対してThreadsが表示する上位投稿を、1回の検索につき約20件返します。対象範囲を広げるには、関連するキーワードやハッシュタグを別々の検索として実行してください。
ThreadsやInstagramへのログインは必要ですか?
いいえ。リクエストに含まれるのは、SocQのAPIキーとクエリまたは公開ThreadsのURLのみで、Threadsアカウントの認証情報は含まれません。
User Repostsでは誰がリポストしたかが分かりますか?
1つのプロフィールを指定してリクエストするため、すべての行はそのプロフィールがリポストしたものです。各行のauthorは元の投稿者です。
複数のプロフィールや投稿をまとめて送信できますか?
はい。Post Replies、User Replies、User Repostsはurlsにリストを受け付け、結果の件数はURLごとに適用されます。
Threadsのすべてのエンドポイントと料金はどこで確認できますか?
Threadsプラットフォームのページと料金ページでご確認いただけます。