プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Threadsの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードに言及しているThreadsの投稿を取得します。各投稿のテキスト、投稿者、いいね数とコメント数、公開日時が含まれます。名前によるプロフィール検索は行わず、全履歴やリアルタイムの網羅性も保証しません。 | 1,000リクエストあたり$0.56 | 正常 |
プロフィールprofile | ハンドルからThreadsアカウントを確認します。表示名、自己紹介、フォロワー数、外部リンク、認証と非公開のフラグを取得できます。ハンドルは@の有無を問わず指定できます。プロフィールURLは使用できません。非公開プロフィールの中身は取得しません。 | 1,000リクエストあたり$0.56 | 正常 |
ユーザーの投稿user_posts | Threadsアカウントの投稿を一覧表示します。いいね、コメント、再投稿、引用、シェア、閲覧の各数を個別に取得でき、ハッシュタグとメンションも含まれます。プロフィールURLではなくハンドルを指定してください。1回のバッチで全履歴を網羅できるとは限らず、そのアカウントの返信は含まれません。 | 1,000リクエストあたり$0.56 | 正常 |
投稿詳細post_detail | 完全なURLから、Threadsの投稿を1件読み取ります。テキスト、投稿者、エンゲージメント数、ハッシュタグ、メディア、有償パートナーシップのフラグを取得できます。返すのはその投稿のみで、前後のスレッド全体は含まれません。 | 1,000リクエストあたり$0.56 | 正常 |
コメントcomments | Threadsの投稿に付いた返信を収集します。各返信には、テキスト、投稿者、認証状況、いいね数、返信先が含まれます。投稿の完全なURLを指定してください。ネストされた返信がすべて返されるとは限りません。 | 1,000リクエストあたり$0.56 | 正常 |
プロフィール探索discover_profiles | キーワードに関連するThreadsのクリエイタープロフィールを探します。自己紹介、フォロワー数、認証状況、外部リンク、掲載されているメールアドレスや電話番号を取得できます。非同期ジョブとして実行されるため、最初のステータス応答ではなく、完了後の結果を読み取ってください。一致しても、本人であることや適合性が証明されるわけではありません。 | 1,000リクエストあたり$0.56 | 正常 |
フォロワーfollowers | Threadsアカウントのフォロワー数、フォロー数、投稿数、いいね数を取得します。丸められた数値を示すprecisionフラグも含まれます。返すのは件数のみで、フォロワーの一覧や時系列の推移は含まれません。 | 1,000リクエストあたり$0.56 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Threadsの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードに言及しているThreadsの投稿を取得します。各投稿のテキスト、投稿者、いいね数とコメント数、公開日時が含まれます。名前によるプロフィール検索は行わず、全履歴やリアルタイムの網羅性も保証しません。 | keyword | — | Sync配信 | カタログ値：defaultLimit=15、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · url · text · author_name · author_username · author_id · like_count · comment_count · posted_at · author_is_verified · media · hashtags · mentions · links · platform |
profileプロフィール ハンドルからThreadsアカウントを確認します。表示名、自己紹介、フォロワー数、外部リンク、認証と非公開のフラグを取得できます。ハンドルは@の有無を問わず指定できます。プロフィールURLは使用できません。非公開プロフィールの中身は取得しません。 | username | — | Sync配信 | — | 1,000リクエストあたり$0.56 | user_id · username · display_name · bio · follower_count · is_verified · is_private · url · avatar_url · platform · external_url |
user_postsユーザーの投稿 Threadsアカウントの投稿を一覧表示します。いいね、コメント、再投稿、引用、シェア、閲覧の各数を個別に取得でき、ハッシュタグとメンションも含まれます。プロフィールURLではなくハンドルを指定してください。1回のバッチで全履歴を網羅できるとは限らず、そのアカウントの返信は含まれません。 | username | — | Sync配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · platform · media_type · hashtags · mentions |
post_detail投稿詳細 完全なURLから、Threadsの投稿を1件読み取ります。テキスト、投稿者、エンゲージメント数、ハッシュタグ、メディア、有償パートナーシップのフラグを取得できます。返すのはその投稿のみで、前後のスレッド全体は含まれません。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.56 | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · is_paid_partnership · author_id · author_avatar_url · image_count · image_urls · platform · media_url · hashtags |
commentsコメント Threadsの投稿に付いた返信を収集します。各返信には、テキスト、投稿者、認証状況、いいね数、返信先が含まれます。投稿の完全なURLを指定してください。ネストされた返信がすべて返されるとは限りません。 | url | — | Sync配信 | — | 1,000リクエストあたり$0.56 | id · url · text · author_username · author_name · author_is_verified · like_count · comment_count · reply_to · posted_at · platform |
discover_profilesプロフィール探索 キーワードに関連するThreadsのクリエイタープロフィールを探します。自己紹介、フォロワー数、認証状況、外部リンク、掲載されているメールアドレスや電話番号を取得できます。非同期ジョブとして実行されるため、最初のステータス応答ではなく、完了後の結果を読み取ってください。一致しても、本人であることや適合性が証明されるわけではありません。 | keyword | since, until | Async配信 | カタログ値：defaultLimit=10、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$0.56 | username · display_name · bio · follower_count · is_verified · url · avatar_url · platform · emails · phones · external_links |
followersフォロワー Threadsアカウントのフォロワー数、フォロー数、投稿数、いいね数を取得します。丸められた数値を示す | username | channel | Sync配信 | — | 1,000リクエストあたり$0.56 | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
Threadsのsearchのパラメータはそれぞれどういう意味ですか？
キーワードに言及しているThreadsの投稿を取得します。各投稿のテキスト、投稿者、いいね数とコメント数、公開日時が含まれます。名前によるプロフィール検索は行わず、全履歴やリアルタイムの網羅性も保証しません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- searchで公開投稿を、discover_profilesでクリエイターのプロフィールを検索するためのクエリを指定します。discover_profilesアクションは非同期で動作するため、最初に返されるタスクステータスのレスポンスを最終的なクリエイターリストとして解析しないでください。Meta公式ドキュメント：Threadsのキーワード検索とエンゲージメント指標 — Metaの公式情報では、検索キーワードによる公開投稿の検索を定義し、返信、再投稿、引用、プラットフォーム外へのシェアを区別しています。これはThreadsの製品オブジェクトと用語を定義するものであり、このAPIのエンドポイントが公式の絞り込み、書き込み、分析の機能をすべてサポートしていることを示すものではありません。 · 確認日
Threadsのprofileのパラメータはそれぞれどういう意味ですか？
ハンドルからThreadsアカウントを確認します。表示名、自己紹介、フォロワー数、外部リンク、認証と非公開のフラグを取得できます。ハンドルは@の有無を問わず指定できます。プロフィールURLは使用できません。非公開プロフィールの中身は取得しません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profile、user_posts、followersアクションで、Threadsのハンドル（@の有無は問いません）を指定します。profileとuser_postsアクションでは、プロフィールの完全なURLは使用できません。followersアクションは、個々のフォロワーの一覧ではなく、フォロワー総数を返します。Meta公式ドキュメント：Threadsのプロフィール、フォロワー数、アクセス制限 — Metaの公式情報では`username`、表示名、自己紹介、`follower_count`を定義しています。また、公開プロフィールの検索には特定の権限が必要であること、標準アクセスは一部の公式アカウントに限られること、公開アカウントやフォロワー数の基準があることを説明しています。ここではプラットフォームの用語を説明するためだけに参照しており、このAPIがこれらの権限を持つことや、公式エンドポイントと同等の機能を持つことを意味するものではありません。 · 確認日
Threadsのuser_postsのパラメータはそれぞれどういう意味ですか？
Threadsアカウントの投稿を一覧表示します。いいね、コメント、再投稿、引用、シェア、閲覧の各数を個別に取得でき、ハッシュタグとメンションも含まれます。プロフィールURLではなくハンドルを指定してください。1回のバッチで全履歴を網羅できるとは限らず、そのアカウントの返信は含まれません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profile、user_posts、followersアクションで、Threadsのハンドル（@の有無は問いません）を指定します。profileとuser_postsアクションでは、プロフィールの完全なURLは使用できません。followersアクションは、個々のフォロワーの一覧ではなく、フォロワー総数を返します。Meta公式ドキュメント：ユーザー名によるThreads投稿の特定 — Metaの公式情報ではユーザープロフィールのエンドポイントとユーザー投稿のエンドポイントを区別し、`profile_posts`がユーザー名の完全一致で投稿を特定する方法を説明するとともに、`id`、`shortcode`、`permalink`などの個別のフィールドを挙げています。公式の`access_token`、ページネーション、日付のパラメータが、このAPIのエンドポイントでサポートされていると想定しないでください。 · 確認日
Threadsのpost_detailのパラメータはそれぞれどういう意味ですか？
完全なURLから、Threadsの投稿を1件読み取ります。テキスト、投稿者、エンゲージメント数、ハッシュタグ、メディア、有償パートナーシップのフラグを取得できます。返すのはその投稿のみで、前後のスレッド全体は含まれません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- post_detailおよびcommentsアクションで、投稿の完全なURL（例：https://www.threads.com/@username/post/POST_CODE）を指定します。commentsアクションでは、ネストされたすべてのコメントスレッドを取得できることは保証されません。Meta公式ドキュメント：Threadsの再投稿、引用、プラットフォーム外へのシェア — Metaの公式情報では再投稿、引用、シェアを区別しており、シェアはプラットフォーム外での共有に限定して定義されています。これは元の投稿のエンゲージメント指標を明確にするものですが、すべてのレスポンスにすべての指標が含まれることや、投稿アクションがサポートされていることを保証するものではありません。 · 確認日
Threadsのcommentsのパラメータはそれぞれどういう意味ですか？
Threadsの投稿に付いた返信を収集します。各返信には、テキスト、投稿者、認証状況、いいね数、返信先が含まれます。投稿の完全なURLを指定してください。ネストされた返信がすべて返されるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- post_detailおよびcommentsアクションで、投稿の完全なURL（例：https://www.threads.com/@username/post/POST_CODE）を指定します。commentsアクションでは、ネストされたすべてのコメントスレッドを取得できることは保証されません。Meta公式ドキュメント：トップレベルの返信と会話ツリー全体の違い — Metaの公式情報ではトップレベルの返信と、深さ無制限の会話全体を区別し、`replied_to`を直接の親コンテンツのIDと定義しています。このAPIの`reply_to`は返信先のユーザー名を表し、公式の`replied_to`フィールドとは異なります。また、コメントツリー全体の取得は保証されません。公式の公開範囲や著作権の制限により、フィールドが欠落する場合もあります。 · 確認日Meta公式ドキュメント：Threadsの返信の読み取りに必要な権限 — Metaの返信管理に関する公式ドキュメントは、アカウント自身のThreads投稿を対象としており、適切なアクセストークンと読み取り権限が必要です。これを参照しても、任意の第三者の投稿にアクセスできることは保証されず、本製品がプラットフォームの許可を得ていることの証明にもなりません。 · 確認日
Threadsのdiscover_profilesのパラメータはそれぞれどういう意味ですか？
キーワードに関連するThreadsのクリエイタープロフィールを探します。自己紹介、フォロワー数、認証状況、外部リンク、掲載されているメールアドレスや電話番号を取得できます。非同期ジョブとして実行されるため、最初のステータス応答ではなく、完了後の結果を読み取ってください。一致しても、本人であることや適合性が証明されるわけではありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- searchで公開投稿を、discover_profilesでクリエイターのプロフィールを検索するためのクエリを指定します。discover_profilesアクションは非同期で動作するため、最初に返されるタスクステータスのレスポンスを最終的なクリエイターリストとして解析しないでください。Meta公式ドキュメント：公開プロフィール検索とキーワードによる厳密なユーザー検索の違い — Meta公式の`profile_lookup`ではユーザー名の完全一致が必要で、権限、アクセスレベル、アカウント要件による制限を受けます。このAPIにおけるキーワードでのプロフィール候補検索を、公式の完全一致検索と同等に扱わないでください。また、公式ドキュメントはすべてのユーザーを網羅することも保証していません。 · 確認日
since任意- discover_profilesで使用する、共通の日付下限パラメータです。検出されたプロフィールが絞り込まれるとは限らず、アカウントの作成日による絞り込みも行いません。
until任意- discover_profilesで使用する、共通の日付上限パラメータです。その期間のクリエイターをすべて取得できることは保証されません。また、searchには日付フィルターがありません。
Threadsのfollowersのパラメータはそれぞれどういう意味ですか？
Threadsアカウントのフォロワー数、フォロー数、投稿数、いいね数を取得します。丸められた数値を示すprecisionフラグも含まれます。返すのは件数のみで、フォロワーの一覧や時系列の推移は含まれません。
username必須- profile、user_posts、followersアクションで、Threadsのハンドル（@の有無は問いません）を指定します。profileとuser_postsアクションでは、プロフィールの完全なURLは使用できません。followersアクションは、個々のフォロワーの一覧ではなく、フォロワー総数を返します。Meta公式ドキュメント：Threadsのプロフィール、フォロワー数、アクセス制限 — Metaの公式情報では`username`、表示名、自己紹介、`follower_count`を定義しています。また、公開プロフィールの検索には特定の権限が必要であること、標準アクセスは一部の公式アカウントに限られること、公開アカウントやフォロワー数の基準があることを説明しています。ここではプラットフォームの用語を説明するためだけに参照しており、このAPIがこれらの権限を持つことや、公式エンドポイントと同等の機能を持つことを意味するものではありません。 · 確認日
channel任意- followersアクションでアカウントのハンドルを指定するための互換用フォールバックです。usernameより優先度が低く、チャンネルやグループのメンバーリストではなくフォロワー数を返します。
Threads APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"threads","action":"search","params":{"keyword":"<keyword>"}}'
Threadsのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
マルチプラットフォームの評判モニタリング設計：ネガティブな変化を評価する前に範囲を決める
監視対象リスト、コメントの識別子、増分カーソルを起点に、追跡可能な評判モニタリングのワークフローを設計します。オフラインのサンプルで重複排除と取り込み漏れを示しつつ、人によるレビューを維持します。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むThreads APIに関する質問
Threads APIでは何を取得できますか？
platformをthreadsに設定します。現在のカタログには検索、プロフィール、ユーザーの投稿、投稿詳細、コメント、moreが掲載されています。これらのアクション名はそれぞれ異なるThreadsのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Threadsに公式APIはありますか？
はい。MetaのThreads APIは、ユーザー自身のThreads投稿を公開・管理するためのAPIです。キーワードによる公開投稿の検索や公開プロフィールの取得には、threads_keyword_searchとthreads_profile_discoveryの権限が必要です。これらの権限の取得にはMetaのアプリレビューが必要で、ユーザーごとに24時間あたり検索2,200回、プロフィール参照1,000回の上限があります。
公式情報源： Meta：Threadsのキーワード検索 · Meta：Threads APIの概要 · 確認日
Threadsの開発者アカウントやAPIキーは必要ですか？
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。Threadsの開発者アプリの登録、Threads APIへのアクセス申請、Threadsアカウントでのログインは必要ありません。また、アクションが返すのはThreadsの公開データのみです。
Threads APIの料金は1,000リクエストあたりいくらですか？
アクションに応じて1,000リクエストあたり$0.56、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
Threadsのsearchリクエストを開始するには、どの入力を使用しますか？
searchで公開投稿を、discover_profilesでクリエイターのプロフィールを検索するためのクエリを指定します。discover_profilesアクションは非同期で動作するため、最初に返されるタスクステータスのレスポンスを最終的なクリエイターリストとして解析しないでください。params内のkeywordとして送信してください。
Threadsのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtext、author_name、author_username、author_idが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Threadsのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信とasync配信が含まれています。