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は、認可された投稿、返信、インサイト、対応する検索のワークフローを目的に設計されています。
| 機能 | SocQ | Threads API |
|---|---|---|
| 主な用途 | 公開プロフィール、投稿、ユーザーの最近の投稿の取得 | 認可済みの投稿、返信、インサイト、検索の連携の構築 |
| 顧客側のOAuth | SocQのAPIキーのみ。顧客のThreads OAuthは不要 | Metaアプリ、Threadsユーザーの認可、アクセストークン |
| 入力の起点 | 公開Threadsのプロフィールまたは投稿のURL | 認可済みアカウントのコンテキスト、ThreadsのID、対応する検索パラメータ |
| 投稿・返信の管理 | 非対応 | 必要なThreadsの権限があれば対応 |
| レスポンス形式 | 正規化されたSocQレコード | Threads Graph API独自のオブジェクト |
Threads APIの仕組み
Profiles、Posts、User Postsはいずれも、共通の非同期タスクとページネーション付きの結果取得ワークフローを使用します。
1. 公開URLを送信
プロフィールまたは投稿のURLを対応するAPIに送信し、返された task_id を保存します。
2. タスクを追跡
処理が完了するまで /v1/tasks/{task_id} をポーリングします。
3. 結果を取得
data.results.items を読み取り、has_more が true の間は next_cursor を使用します。
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 trueThreads 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件の解決ができ、正規化レコードとして返します。







