API一覧に戻る
Threadsの公開データ

Threads公開データAPI

公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。

利用できるThreads API

アカウントのデータにはProfiles、既知の公開投稿1件にはPosts、指定したプロフィールから上限付きで投稿を取得するにはUser Postsを使用します。

取得できるThreadsデータ

SocQは、アカウント情報、コンテンツ、メディア、表示中のエンゲージメント、取得元、取得時点のコンテキストを含む、正規化された公開アカウントと投稿のレコードを返します。

公開プロフィールの詳細

プロフィールID、URL、ユーザー名、表示名、プロフィール文、画像、リンクされたWebサイト、表示中のアカウント数値、取得日時を取得します。

既知の投稿のコンテンツ

公開投稿のURLから、投稿ID、本文、投稿者の詳細、取得元URL、取得可能なメディアを取得します。

表示中の投稿エンゲージメント

公開日時と取得日時を、取得可能ないいね数、コメント数、再投稿数、シェア数とあわせて保持します。

指定したプロフィールの投稿

各プロフィールURLから上限付きで公開投稿を閲覧し、送信したプロフィールと結果を紐づけて保持します。

SocQ vs Threads API

SocQは、対応する公開Threadsデータの取得に特化しています。MetaのThreads APIは、認可された投稿、返信、インサイト、対応する検索のワークフローを目的に設計されています。

機能SocQThreads API
主な用途公開プロフィール、投稿、ユーザーの最近の投稿の取得認可済みの投稿、返信、インサイト、検索の連携の構築
顧客側のOAuthSocQのAPIキーのみ。顧客のThreads OAuthは不要Metaアプリ、Threadsユーザーの認可、アクセストークン
入力の起点公開Threadsのプロフィールまたは投稿のURL認可済みアカウントのコンテキスト、ThreadsのID、対応する検索パラメータ
投稿・返信の管理非対応必要なThreadsの権限があれば対応
レスポンス形式正規化されたSocQレコードThreads Graph API独自のオブジェクト

Threads APIの仕組み

Profiles、Posts、User Postsはいずれも、共通の非同期タスクとページネーション付きの結果取得ワークフローを使用します。

  1. 1. 公開URLを送信

    プロフィールまたは投稿のURLを対応するAPIに送信し、返された task_id を保存します。

  2. 2. タスクを追跡

    処理が完了するまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 結果を取得

    data.results.items を読み取り、has_more が true の間は next_cursor を使用します。

Threadsプロフィールの投稿を取得

SocQのAPIキーで認証し、公開プロフィールのURLをUser Postsに送信します。ProfilesとPostsも同じタスクフローで利用できます。

curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Threads APIの主なユースケース

クリエイターとプロフィールの調査

既知のプロフィールURLに、公開されているアカウント情報、プロフィール文、Webサイト、表示中のアカウント指標、取得日時を追加します。

既知の投稿の分析

選んだ投稿URLから、コンテンツ、投稿者、メディア、公開日時、表示中のエンゲージメント、取得元のフィールドを取得します。

クリエイターのコンテンツモニタリング

指定したプロフィールから上限付きで投稿を取得し、繰り返し取得した結果の間でコンテンツを比較します。

エンゲージメントのレポート

表示中の数値と collected_at を使って公開投稿のスナップショットを比較します。リアルタイムの指標としては扱わないでください。

制限事項と公開データポリシー

Threadsの結果は、特定時点の公開レコードです。これらのAPIは非公開コンテンツにはアクセスせず、Threadsのアカウントや投稿の公開、編集、削除、管理も行いません。

  • Profilesは、threads.com と threads.net の /@username 形式のURLを受け付けます。ユーザー名のみや投稿URLは受け付けません。
  • Postsは /@username/post/{post_id} 形式のURLを受け付けます。results_limit やプロフィールの投稿の検索には対応していません。
  • User Postsは /@username 形式のプロフィールURLを受け付けます。results_limit のデフォルトは100で、1〜2,000を指定でき、プロフィールごとに個別に適用されます。
  • User Postsでは、結果がオリジナル投稿、返信、引用、再投稿のいずれであるかは識別されません。
  • 投稿には comments_count が含まれる場合がありますが、個々の返信や返信ツリーは返されません。
  • 公開レコードで提供されていない場合、任意のアカウント情報、コンテンツ、メディア、タイムスタンプ、エンゲージメントのフィールドは空になることがあります。

Threads APIに関するよくある質問

Threads APIとは何ですか?

Threads APIは、公開プロフィールデータの取得、既知の投稿の解決、指定したプロフィールからの上限付きの投稿取得ができるSocQのエンドポイント群です。

どのThreads APIを使えばよいですか?

/@username のアカウントレコードにはProfiles、正確な /@username/post/{post_id} のリンクにはPosts、各 /@username のプロフィールURLから上限付きで取得するにはUser Postsを使用してください。

User Postsの取得件数上限はどのように機能しますか?

results_limit のデフォルトは100で、1〜2,000の整数を指定でき、送信した各プロフィールURLに個別に適用されます。

User Postsの結果で返信や再投稿を識別できますか?

正規化された結果には、投稿のサブタイプは含まれません。各アイテムは、送信したプロフィールから見つかった公開投稿として扱い、オリジナル、返信、引用、再投稿のいずれであるかは推測しないでください。

Threadsの投稿やエンゲージメント指標は完全、またはリアルタイムですか?

いいえ。結果は取得時点で取得可能な公開フィールドを反映したもので、返信ツリー全体は含まれません。リアルタイムのフィードではなく、特定時点のスナップショットとして扱ってください。

Threadsデータ取得の料金はどのように計算されますか?

返されたプロフィールは1件あたり0.6クレジット、PostsまたはUser Postsから返された投稿は1件あたり0.5クレジットです。結果が空の場合、結果に対する料金は発生しません。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

Bluesky API

公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。

Snapchat API

既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。

Twitch API

既知の公開Twitchユーザー名から正規化されたプロフィールや公開動画の一覧を取得したり、クリップ1件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。

Rednote API

公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。

Kwai API

公開Kwaiプロフィール、アカウントの投稿1ページ分、既知の投稿1件を取得できます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントは正規化されています。

Truth Social API

公開アカウントの詳細の取得、アカウントの投稿の取得元1ページ分の取得、既知の投稿URL 1件の解決ができ、正規化レコードとして返します。