Bluesky Post
Bluesky投稿は、本文、投稿者の識別情報、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメント数を含む公開コンテンツです。これらのレコードは、URLの情報補完、ソースの確認、コンテンツリサーチ、タイムスタンプ付きのエンゲージメント比較に活用できます。
Bluesky Post API の主な機能
- 既知の投稿の照会アカウントのフィードを展開するのではなく、公開bsky.appのURL1件を、選択した投稿の正規化レコードに変換します。
- コンテンツと投稿者の情報取得可能な投稿本文、ソースURL、投稿者の識別情報、添付メディア、ハッシュタグ、メンション、公開日時をまとめて返します。
- 表示中のエンゲージメントのスナップショット取得可能ないいね数、コメント数、リポスト数、閲覧数を取得日時とともに保持し、特定時点の観測値として記録します。
Bluesky Post API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須 | 必須。解析後のホスト名がbsky.appまたはbsky.appのサブドメインである、空でない投稿参照です。送信時の検証では、任意のスキームの絶対参照とプロトコル相対参照を受け付けます。 |
Bluesky Post API の使い方
既知の公開Bluesky投稿のURLを送信して非同期タスクを追跡し、標準の結果エンベロープから正規化された結果を読み取ります。
- 確認したいBluesky投稿に解決される公開bsky.appのURLを1件用意します。
- URLを url として /v1/bluesky/post に送信し、返された task_id を保存します。
- タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取ります。結果エンベロープで has_more が true と報告された場合に限り next_cursor をたどります。
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueBluesky Post API の主なユースケース
- 既知の投稿URLの情報補完: 選択したbsky.appのリンクを、本文、投稿者、メディア、タイムスタンプ、タグ、メンション、指標、ソースの各フィールドを持つ構造化データに変換します。
- コンテンツと出典の確認: 投稿本文、投稿者の識別情報、メディア、公開ソースURLを使い、出典をたどれる形で選択した投稿を確認します。
- エンゲージメント観測値の比較: 表示中のエンゲージメント数を collected_at と組み合わせ、リアルタイムのストリームとしては扱わずに、別々に取得したスナップショットを比較します。
Bluesky Post API 活用のヒント
- 解析後のホスト名がbsky.appまたはbsky.appのサブドメインであることを確認してください。送信時の検証ではURLのスキームを制限せず、プロトコル相対参照も受け付けます。
- 入力はフィードのページではなく選択した1件の投稿を指定するものなので、タスクごとに投稿URLを1件使用し、results_limit は省略してください。
- 投稿本文、投稿者の詳細、メディア、ハッシュタグ、メンション、公開日時、個々の指標は null 許容のフィールドとして扱ってください。
- 後で比較する際に各観測の時点がわかるよう、表示中のエンゲージメント数とともに collected_at を保存してください。
関連API
Bluesky Post API 以外に別の種類の公開Blueskyデータが必要な場合は、これらのAPIをご利用ください。
- Bluesky Profile API — 検証済みのユーザー名から公開Blueskyプロフィール1件を取得し、正規化されたアカウント情報、プロフィール文、画像、Webサイト、状態フィールド、表示中のアカウントのカウント、取得情報を返します。
- Bluesky User Posts API — ハンドルまたはDIDから公開Bluesky投稿を1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。