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件送信して非同期タスクを追跡し、標準の結果レスポンスから正規化プロフィールを読み取ります。
- jay.bsky.team のように英字、数字、ドット、ハイフンで構成されるBlueskyユーザー名を1件用意し、先頭の @ は外します。
- username を /v1/bluesky/profile に送信し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- 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.itemsBluesky Profile API の主なユースケース
- 既知プロフィールの情報補完: Blueskyユーザー名をすでに持つレコードに、公開ハンドル、表示名、プロフィール文、プロフィール画像、Webサイト、ソースURLを追加します。
- アカウント規模の比較: 個別に送信したユーザー名間で、同じ正規化指標キーを使って取得可能なフォロワー数・フォロー数・投稿数を比較します。
- プロフィール表示内容のモニタリング: 繰り返し実行したタスクで識別情報、プロフィール文、画像、Webサイト、collected_at を保存し、公開スナップショット間の変化を把握します。
Bluesky Profile API 活用のヒント
- 送信前に先頭の @ を取り除き、残りのユーザー名が英字、数字、ドット、ハイフンのみで構成されているか検証してください。このエンドポイントは user_id を受け付けないため、DIDの値は除外してください。
- 重複排除のキーには返された id を優先して使い、id が空の場合は url または username で代用してください。
- 一部のみ取得できた公開レコードも活用できるよう、プロフィール文、アバター、カバー画像、Webサイト、ステータスフラグ、所在地、個々の指標が null になることを許容してください。
- results_limit やユーザー名の配列は追加しないでください。ユーザー名ごとに固定料金のタスクとして送信し、通常の結果はプロフィール1件として扱ってください。
関連API
Bluesky Profile API 以外に別の種類の公開Blueskyデータが必要な場合は、これらのAPIをご利用ください。
- Bluesky Post API — 既知の公開bsky.app投稿URL 1件から、正規化されたテキスト、投稿者、メディア、タイムスタンプ、タグ、メンション、表示中のエンゲージメントの各フィールドを取得します。
- Bluesky User Posts API — ハンドルまたはDIDから公開Bluesky投稿を1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。