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

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. 1. 対応する識別子を送信

    ユーザー名、投稿URL、ハンドル、またはDIDを対応するAPIに送信し、返された task_id を保存します。

  2. 2. タスクを追跡

    処理が成功または失敗するまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 結果を取得

    data.results.items を読み取り、保存済みの結果がまだ残っている間だけ next_cursor を使用します。

Blueskyのハンドルで投稿を取得

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 success

Bluesky 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件の取得ができ、調査やレビューに活用できます。