bluesky/
profile

検証済みのユーザー名から公開Blueskyプロフィールを1件取得し、正規化されたアカウント情報、プロフィール文、プロフィール画像、Webサイト、表示中のアカウント数値を1つの非同期タスクで返します。

Bluesky Profile API

検証済みユーザー名の入力
プロフィールの識別情報と画像
表示中のアカウント数値
1リクエストあたり0.19クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Bluesky Profile

Blueskyプロフィールは、永続的な識別子、ハンドル、表示名、プロフィール文、プロフィール画像、Webサイト、表示中のフォロワー数・フォロー数・投稿数を含む公開アカウントレコードです。これらの識別情報とアカウント指標は、プロフィール情報の補完、公開アカウントの比較、経時的な観測に活用できます。

Bluesky Profile API の主な機能

  • ユーザー名による直接照会英字、数字、ドット、ハイフンで構成される1〜253文字のユーザー名1件を、公開プロフィールレコードに変換します。
  • 正規化されたプロフィール識別情報取得可能なプロフィールID、ソースURL、ユーザー名、表示名、プロフィール文、リンク先のWebサイトを、統一されたアカウント形式で返します。
  • プロフィール画像とステータスのフィールド取得可能なアバター、カバー画像、認証、非公開の値を null 許容のフィールドとして保持し、ソースにない値を補完することはありません。
  • 表示中のアカウント数値のスナップショット取得可能なフォロワー数・フォロー数・投稿数を collected_at とまとめ、公開アカウントの各スナップショットに観測時刻を付与します。

Bluesky Profile API のパラメータ

パラメータ必須説明
username必須必須。英字、数字、ドット、ハイフンで構成される1〜253文字の公開Blueskyユーザー名です。先頭の @、アンダースコア、DID、プロフィールURL、2つ目のユーザー名は含めないでください。

Bluesky Profile API の使い方

検証済みのユーザー名を1件送信して非同期タスクを追跡し、標準の結果レスポンスから正規化プロフィールを読み取ります。

  1. jay.bsky.team のように英字、数字、ドット、ハイフンで構成されるBlueskyユーザー名を1件用意し、先頭の @ は外します。
  2. username を /v1/bluesky/profile に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。この照会では通常プロフィールが1件保存されるため has_more は false ですが、汎用の結果レスポンスで追加データがあると報告された場合は next_cursor を使って続きを取得します。
curl -X POST "https://api.socq.ai/v1/bluesky/profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"jay.bsky.team"}'

# Poll GET /v1/tasks/{task_id}
# Read the profile from data.results.items

Bluesky Profile API の主なユースケース

  • 既知プロフィールの情報補完: Blueskyユーザー名をすでに持つレコードに、公開ハンドル、表示名、プロフィール文、プロフィール画像、Webサイト、ソースURLを追加します。
  • アカウント規模の比較: 個別に送信したユーザー名間で、同じ正規化指標キーを使って取得可能なフォロワー数・フォロー数・投稿数を比較します。
  • プロフィール表示内容のモニタリング: 繰り返し実行したタスクで識別情報、プロフィール文、画像、Webサイト、collected_at を保存し、公開スナップショット間の変化を把握します。

Bluesky Profile API 活用のヒント

  • 送信前に先頭の @ を取り除き、残りのユーザー名が英字、数字、ドット、ハイフンのみで構成されているか検証してください。このエンドポイントは user_id を受け付けないため、DIDの値は除外してください。
  • 重複排除のキーには返された id を優先して使い、id が空の場合は url または username で代用してください。
  • 一部のみ取得できた公開レコードも活用できるよう、プロフィール文、アバター、カバー画像、Webサイト、ステータスフラグ、所在地、個々の指標が null になることを許容してください。
  • results_limit やユーザー名の配列は追加しないでください。ユーザー名ごとに固定料金のタスクとして送信し、通常の結果はプロフィール1件として扱ってください。

Bluesky Profile API 以外に別の種類の公開Blueskyデータが必要な場合は、これらのAPIをご利用ください。

  • Bluesky Post API — 既知の公開bsky.app投稿URL 1件から、正規化されたテキスト、投稿者、メディア、タイムスタンプ、タグ、メンション、表示中のエンゲージメントの各フィールドを取得します。
  • Bluesky User Posts API — ハンドルまたはDIDから公開Bluesky投稿を1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

他のプラットフォームを見る

Blueskyのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Bluesky Profile API — よくある質問

Bluesky Profile APIは、検証済みのユーザー名から公開Blueskyプロフィールを1件取得するためのプログラムインターフェースです。正規化されたアカウント情報、プロフィール文、プロフィール画像、Webサイト、任意のステータスフィールド、表示中のアカウント数値、取得日時を返します。

先頭に @ を付けず、英字、数字、ドット、ハイフンで構成される1〜253文字で送信してください。アンダースコア、コロン、プロフィールURL、DID、空の値、追加のリクエストフィールドは拒否されます。

標準のアカウントレコードには、識別情報とソースのフィールド、ユーザー名、表示名、プロフィール文、アバター、カバー画像、Webサイト、認証・非公開の値、任意の所在地、フォロワー数・フォロー数・投稿数、取得日時が含まれます。任意フィールドは取得できない場合 null のままです。

対応していません。各タスクで受け付けるユーザー名は1件で、通常は最大1件のプロフィールを返し、results_limit や呼び出し側が指定する入力カーソルはありません。なお、タスク結果には標準の next_cursor と has_more のエンベロープが使われます。

成功したタスク1件につき、固定で0.19 SocQクレジットです。リクエストではプロフィールの照会を1回行うだけのため、料金は結果件数に比例しません。