Bluesky User Posts
Blueskyユーザー投稿は、ハンドルまたは分散型識別子(DID)を使って1つのアカウントから収集する公開投稿です。正規化された各レコードには、投稿本文、投稿者の識別情報、ソース上の日時と取得日時、公開メディア、ハッシュタグ、メンション、取得可能なエンゲージメント数を保持できます。
Bluesky User Posts API の主な機能
- 2種類のアカウント識別子jay.bsky.team のようなBlueskyハンドル、または did:method:identifier 形式に一致するDIDのいずれか1つだけを送信します。
- 1ページ分のアカウント収集選択したアカウントについてプロバイダーへのリクエストを1回送信し、そのソースページに表示される公開投稿を収集します。呼び出し側でソースのカーソルや結果の上限を指定することはできません。
- 安定した投稿形式の結果プロバイダーのレスポンスエンベロープに依存せず、正規化された投稿の識別情報、本文、投稿者、タイムスタンプ、指標、メディア、ハッシュタグ、メンションを読み取れます。
Bluesky User Posts API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
username | 必須(いずれか1つ以上) | 英字、数字、ピリオド、ハイフンで構成される1〜253文字の公開Blueskyハンドルです。先頭の @ は使用できません。代わりに user_id を指定する場合は、このフィールドを省略してください。 |
user_id | 必須(いずれか1つ以上) | did: で始まり、小文字のメソッド名と、使用可能な英字、数字、ピリオド、アンダースコア、コロン、パーセント記号、ハイフンで構成される空でない識別子が続く、Blueskyの分散型識別子(DID)です。 |
Bluesky User Posts API の使い方
BlueskyのハンドルまたはDIDを送信して非同期タスクを追跡し、完了後に保存された PostItem レコードを読み取ります。
- 先頭に @ を付けない公開Blueskyハンドル、またはアカウントのDIDのいずれかを選びます。
- 選んだ識別子を /v1/bluesky/user-posts に POST し、返された task_id を保存します。
- タスクが成功するか失敗を報告するまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取ります。保存された結果セットに次のページがある場合に限り、タスクレスポンスの next_cursor を使用します。
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 the task succeedsBluesky User Posts API の主なユースケース
- アカウントのコンテンツスナップショット: 既知のハンドルまたはDIDについて、特定時点の公開投稿を1ページ分取得し、投稿ID、ソースURL、公開日時、取得日時を保持します。
- 投稿傾向のリサーチ: 正規化された本文、投稿者、ハッシュタグ、メンション、取得可能なメディアを確認し、選択した公開アカウント内のテーマや形式を分析します。
- 表示中のエンゲージメントの比較: 収集した投稿間で取得可能ないいね数、コメント数、シェア数、閲覧数を比較します。値がない指標は0ではなく取得不可として扱います。
Bluesky User Posts API 活用のヒント
- ハンドルは @ を付けずに送信し、タスクを作成する前に英字、数字、ピリオド、ハイフンのみで構成されているか検証してください。
- ハンドルが変更されてもアカウントを一意に識別し続ける必要がある場合は、完全なDIDを使用してください。任意のユーザーIDは送信しないでください。
- POST ペイロードに results_limit やソースのカーソルを追加しないでください。プロバイダーの収集は1ページ分のみで、これらのフィールドは拒否されます。
- 投稿者の詳細、メディア、ハッシュタグ、メンション、個々の指標は任意として扱い、繰り返し取得したスナップショットは投稿の id で重複排除してください。
関連API
Bluesky User Posts API 以外に別の種類の公開Blueskyデータが必要な場合は、これらのAPIをご利用ください。
- Bluesky Profile API — 検証済みのユーザー名から公開Blueskyプロフィール1件を取得し、正規化されたアカウント情報、プロフィール文、画像、Webサイト、状態フィールド、表示中のアカウントのカウント、取得情報を返します。
- Bluesky Post API — 既知の公開bsky.app投稿URL 1件から、正規化されたテキスト、投稿者、メディア、タイムスタンプ、タグ、メンション、表示中のエンゲージメントの各フィールドを取得します。