bluesky/
post

既知のbsky.appのURLから公開Bluesky投稿を1件収集し、本文、投稿者の識別情報、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメントを返します。

Bluesky Post API

投稿URLを1件指定
投稿者情報
エンゲージメントのスナップショット
1リクエストあたり0.19クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Bluesky Post

Bluesky投稿は、本文、投稿者の識別情報、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメント数を含む公開コンテンツです。これらのレコードは、URLの情報補完、ソースの確認、コンテンツリサーチ、タイムスタンプ付きのエンゲージメント比較に活用できます。

Bluesky Post API の主な機能

  • 既知の投稿の照会アカウントのフィードを展開するのではなく、公開bsky.appのURL1件を、選択した投稿の正規化レコードに変換します。
  • コンテンツと投稿者の情報取得可能な投稿本文、ソースURL、投稿者の識別情報、添付メディア、ハッシュタグ、メンション、公開日時をまとめて返します。
  • 表示中のエンゲージメントのスナップショット取得可能ないいね数、コメント数、リポスト数、閲覧数を取得日時とともに保持し、特定時点の観測値として記録します。

Bluesky Post API のパラメータ

パラメータ必須説明
url必須必須。解析後のホスト名がbsky.appまたはbsky.appのサブドメインである、空でない投稿参照です。送信時の検証では、任意のスキームの絶対参照とプロトコル相対参照を受け付けます。

Bluesky Post API の使い方

既知の公開Bluesky投稿のURLを送信して非同期タスクを追跡し、標準の結果エンベロープから正規化された結果を読み取ります。

  1. 確認したいBluesky投稿に解決される公開bsky.appのURLを1件用意します。
  2. URLを url として /v1/bluesky/post に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで /v1/tasks/{task_id} をポーリングします。
  4. 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 true

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

  • 既知の投稿URLの情報補完: 選択したbsky.appのリンクを、本文、投稿者、メディア、タイムスタンプ、タグ、メンション、指標、ソースの各フィールドを持つ構造化データに変換します。
  • コンテンツと出典の確認: 投稿本文、投稿者の識別情報、メディア、公開ソースURLを使い、出典をたどれる形で選択した投稿を確認します。
  • エンゲージメント観測値の比較: 表示中のエンゲージメント数を collected_at と組み合わせ、リアルタイムのストリームとしては扱わずに、別々に取得したスナップショットを比較します。

Bluesky Post API 活用のヒント

  • 解析後のホスト名がbsky.appまたはbsky.appのサブドメインであることを確認してください。送信時の検証ではURLのスキームを制限せず、プロトコル相対参照も受け付けます。
  • 入力はフィードのページではなく選択した1件の投稿を指定するものなので、タスクごとに投稿URLを1件使用し、results_limit は省略してください。
  • 投稿本文、投稿者の詳細、メディア、ハッシュタグ、メンション、公開日時、個々の指標は null 許容のフィールドとして扱ってください。
  • 後で比較する際に各観測の時点がわかるよう、表示中のエンゲージメント数とともに collected_at を保存してください。

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

  • Bluesky Profile API — 検証済みのユーザー名から公開Blueskyプロフィール1件を取得し、正規化されたアカウント情報、プロフィール文、画像、Webサイト、状態フィールド、表示中のアカウントのカウント、取得情報を返します。
  • Bluesky User Posts API — ハンドルまたはDIDから公開Bluesky投稿を1ページ分取得し、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

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

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

Bluesky Post API — よくある質問

Bluesky Post APIは、既知の投稿URLから公開Bluesky投稿を1件取得するためのプログラムインターフェースです。正規化された本文、投稿者の識別情報、メディア、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメント数を返します。

解析後のホスト名がbsky.appまたはbsky.appのサブドメインである、空でない参照を1件送信してください。バックエンドは任意のスキームの絶対参照とプロトコル相対参照を受け付けます。リクエストで使用できるのは url フィールドのみです。

投稿スキーマには、識別情報とソースのフィールド、本文、公開日時と取得日時、投稿者の詳細、メディア、ハッシュタグ、メンション、取得可能ないいね数・コメント数・リポスト数・閲覧数が含まれます。公開ソースが利用可能な値を公開していない場合、null 許容のフィールドは空のままです。

含まれません。結果は選択した投稿を表し、表示中の comments_count が含まれる場合はありますが、投稿スキーマは個別の返信レコードや返信ツリーを返しません。

できません。リクエストは url を1件解決するもので、results_limit は使用できません。返された項目は標準のタスク結果エンベロープから読み取ってください。

成功したBluesky Postタスク1件につき、固定で0.19 SocQクレジットです。料金は、要求した結果件数や返された結果件数には左右されません。