bluesky/
user-posts

ハンドルまたはDIDから公開Bluesky投稿を1ページ分収集し、正規化された本文、投稿者の識別情報、タイムスタンプ、エンゲージメント指標、取得可能なメディアを返します。

Bluesky User Posts API

ハンドルまたはDIDで入力
ソース1ページ分
正規化投稿レコード
1リクエストあたり0.19クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 レコードを読み取ります。

  1. 先頭に @ を付けない公開Blueskyハンドル、またはアカウントのDIDのいずれかを選びます。
  2. 選んだ識別子を /v1/bluesky/user-posts に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を報告するまで /v1/tasks/{task_id} をポーリングします。
  4. 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 succeeds

Bluesky User Posts API の主なユースケース

  • アカウントのコンテンツスナップショット: 既知のハンドルまたはDIDについて、特定時点の公開投稿を1ページ分取得し、投稿ID、ソースURL、公開日時、取得日時を保持します。
  • 投稿傾向のリサーチ: 正規化された本文、投稿者、ハッシュタグ、メンション、取得可能なメディアを確認し、選択した公開アカウント内のテーマや形式を分析します。
  • 表示中のエンゲージメントの比較: 収集した投稿間で取得可能ないいね数、コメント数、シェア数、閲覧数を比較します。値がない指標は0ではなく取得不可として扱います。

Bluesky User Posts API 活用のヒント

  • ハンドルは @ を付けずに送信し、タスクを作成する前に英字、数字、ピリオド、ハイフンのみで構成されているか検証してください。
  • ハンドルが変更されてもアカウントを一意に識別し続ける必要がある場合は、完全なDIDを使用してください。任意のユーザーIDは送信しないでください。
  • POST ペイロードに results_limit やソースのカーソルを追加しないでください。プロバイダーの収集は1ページ分のみで、これらのフィールドは拒否されます。
  • 投稿者の詳細、メディア、ハッシュタグ、メンション、個々の指標は任意として扱い、繰り返し取得したスナップショットは投稿の id で重複排除してください。

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

  • Bluesky Profile API — 検証済みのユーザー名から公開Blueskyプロフィール1件を取得し、正規化されたアカウント情報、プロフィール文、画像、Webサイト、状態フィールド、表示中のアカウントのカウント、取得情報を返します。
  • Bluesky Post API — 既知の公開bsky.app投稿URL 1件から、正規化されたテキスト、投稿者、メディア、タイムスタンプ、タグ、メンション、表示中のエンゲージメントの各フィールドを取得します。

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

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

Bluesky User Posts API — よくある質問

Bluesky User Posts APIは、BlueskyのハンドルまたはDIDからアカウントの公開投稿を1ページ分取得するインターフェースです。正規化された投稿本文、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントデータを返します。

どちらか一方だけを送信してください。username は @ を付けない公開ハンドル、user_id は有効なDIDである必要があります。両方のフィールドを指定すると検証エラーになります。

できません。送信仕様で受け付けるのは username と user_id のみで、プロバイダーの実行ではプロバイダーのカーソルをたどらずにソースを1ページ分収集します。

タスクエンドポイントはSocQがすでに保存したレコードをページネーションし、読み取り時の limit として1〜500を受け付けます。この保存済み結果用のカーソルによって、Blueskyのプロバイダーから別のページが取得されることはありません。

PostItem スキーマには、識別情報、プラットフォームとリソースのラベル、URL、公開日時と取得日時、本文、投稿者、指標、メディア、ハッシュタグ、メンションが含まれます。ソースに依存するフィールドは null になる場合があります。

成功したタスクには固定で0.19 SocQクレジットがかかります。料金は、ソースページから保存された投稿の件数によって変わりません。