Bluesky公開データAPI
公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。
利用できるBluesky API
アカウントのデータにはProfiles、既知の公開投稿1件にはPosts、ハンドルまたはDIDから投稿を1ページ分取得するにはUser Postsを使用します。
取得できるBlueskyデータ
SocQは、取得元と取得時点のコンテキストを含む、正規化された公開プロフィールと投稿のレコードを返します。
公開プロフィールの詳細
取得可能なアカウント情報、プロフィール文、プロフィール画像、Webサイト、アカウントのフラグ、表示中の数値、取得日時を取得します。
既知の投稿のコンテンツ
公開 bsky.app のURLから、投稿ID、本文、投稿者の詳細、メディア、タイムスタンプ、ハッシュタグ、メンションを取得します。
指定したアカウントの投稿
@を含まないハンドルまたは有効なBlueskyのDIDで、公開投稿を取得元の1ページ分取得します。
表示中のエンゲージメント
取得可能ないいね数、コメント数、リポスト数、シェア数、表示回数を、特定時点の観測値として保持します。
SocQとBlueskyへの直接連携の比較
SocQは正規化された非同期のデータ取得ワークフローを提供します。直接連携の場合、通信、取得元のオブジェクト、保存、結果の変換はアプリケーション側で行う必要があります。
| 機能 | SocQ | 直接連携 |
|---|---|---|
| 主な用途 | 公開プロフィール、既知の投稿、アカウントの投稿1ページ分の取得 | 提供元ネイティブの読み取り・書き込みワークフローの構築 |
| 認証 | SocQのAPIキー | ネイティブのメソッドとサービスに応じた認証情報 |
| 入力の起点 | エンドポイントに応じてユーザー名、公開投稿URL、ハンドル、DID | ネイティブの識別子またはメソッド固有のパラメータ |
| レスポンス形式 | 正規化されたSocQレコード | アプリケーション側でマッピングが必要な提供元ネイティブのオブジェクト |
Bluesky APIの仕組み
Profiles、Posts、User Postsはいずれも、共通の非同期タスクと、保存済み結果のページネーションによる取得ワークフローを使用します。
1. 対応する識別子を送信
ユーザー名、投稿URL、ハンドル、またはDIDを対応するAPIに送信し、返された task_id を保存します。
2. タスクを追跡
処理が成功または失敗するまで /v1/tasks/{task_id} をポーリングします。
3. 結果を取得
data.results.items を読み取り、保存済みの結果がまだ残っている間だけ next_cursor を使用します。
SocQのAPIキーで認証し、公開ハンドルをUser Postsに送信します。ProfilesとPostsも同じタスクフローで利用できます。
curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"jay.bsky.team"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successBluesky APIの主なユースケース
プロフィールの調査
既知のユーザー名に、公開されているアカウント情報、プロフィール文、画像、Webサイト、表示中の指標、取得日時を追加します。
既知の投稿の分析
選んだ投稿URLから、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、参照、エンゲージメント、取得元のフィールドを取得します。
公開アカウントのスナップショット
既知のハンドルまたはDIDの投稿を1ページ分取得し、取得元と取得日時を保持します。
エンゲージメントの比較
繰り返し取得した結果の間で表示中のカウンターを比較します。数値は特定時点のスナップショットとして扱ってください。
制限事項と公開データポリシー
Blueskyの結果は、取得時点で取得可能な公開フィールドを表します。これらのAPIは非公開コンテンツにはアクセスせず、アカウントや投稿の公開、編集、削除、管理も行いません。
- Profilesには検証済みのユーザー名が1つ必要で、プロフィールURLは受け付けません。
- Postsは、解析後のホスト名が bsky.app または bsky.app のサブドメインである、空でない参照を1つ受け付けます。任意のスキームを持つ絶対参照やプロトコル相対参照も含みます。アカウントのフィードや返信ツリーは取得しません。
- User Postsには username または user_id が必要です。ハンドルに@を含めることはできず、user_id はDIDである必要があります。
- User Postsは results_limit や取得元のカーソルを受け付けず、提供元の1ページ分のみを取得します。
- タスク結果のカーソルと limit は、SocQがすでに保存したレコードをページ分割するもので、取得元の別ページを取得するものではありません。
- 取得できない場合、任意のアカウント情報、コンテンツ、メディア、タイムスタンプ、参照、エンゲージメントのフィールドは空になることがあります。
Bluesky APIに関するよくある質問
Bluesky APIとは何ですか?
Bluesky APIは、公開プロフィールの取得、既知の投稿の解決、ハンドルまたはDIDによる公開アカウントの投稿1ページ分の取得ができるAPIです。
どのBluesky APIを使えばよいですか?
ユーザー名に基づくアカウントレコードにはProfiles、既知の bsky.app の投稿URL 1件にはPosts、ハンドルまたはDIDから投稿を1ページ分取得するにはUser Postsを使用してください。
User Postsは取得元のカーソルをたどりますか?
いいえ。提供元へのリクエストを1回送信し、取得元の1ページ分を取得します。next_cursor は、SocQがすでに保存した結果レコードを順に進めるためだけに使われます。
すべてのフィールドと指標が常に含まれますか?
いいえ。正規化された形式は安定していますが、取得元に依存するアカウント情報、コンテンツ、メディア、タイムスタンプ、参照、指標の値は null になる場合があります。
Blueskyデータ取得の料金はどのように計算されますか?
Profiles、Posts、User Postsのタスクは、成功1回あたり一律0.19 SocQクレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Snapchat API
既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。
Twitch API
既知の公開Twitchユーザー名から正規化されたプロフィールや公開動画の一覧を取得したり、クリップ1件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。
Rednote API
公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。
Kwai API
公開Kwaiプロフィール、アカウントの投稿1ページ分、既知の投稿1件を取得できます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントは正規化されています。
Truth Social API
公開アカウントの詳細の取得、アカウントの投稿の取得元1ページ分の取得、既知の投稿URL 1件の解決ができ、正規化レコードとして返します。
Google Ad Library API
公開広告主の検索、企業ごとのクリエイティブの取得、URLによる既知の透明性センターのクリエイティブ1件の取得ができ、調査やレビューに活用できます。


