rednote/
home-recommendations

シードとなる検索語なしでRednoteのホームおすすめページを公開分1ページ取得し、正規化された投稿、投稿者、メディア、エンゲージメント、取得日時のフィールドを読み取れます。

Rednote Home Recommendations API

シード入力不要
1ページ分のフィード
正規化された投稿
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Rednote Home Recommendations

ホームおすすめのリクエストでは、プロフィール、ノートURL、検索語を指定しなくても、Rednoteの公開フィードを1ページ取得できます。取得できた各アイテムは、ソースID、テキスト、投稿者、メディア、表示中のエンゲージメント、公開日時、取得日時を含む標準の投稿レコードに変換されます。

Rednote Home Recommendations API の主な機能

  • シード不要のホームフィード取得空のボディ、または確認済みの homefeed_recommend カテゴリを送信するだけで、ユーザーや検索語を用意せずに現在のおすすめページを1ページ取得できます。
  • 上限付きのページサイズ1〜40の整数を指定できます。省略時は20が使われますが、返されるページの公開アイテム数がそれより少なくなる場合があります。
  • プロバイダーに依存しない投稿形式取得可能なノートID、テキスト、投稿者、メディア、タイムスタンプ、表示中の指標を、プロバイダーのフィールド名ではなく共通の投稿スキーマで読み取れます。
  • 永続化された非同期結果1回送信してタスクのステータスを追跡し、プロバイダーからの単一レスポンスが正規化された後にSocQが保存したレコードをページ送りで読み取れます。

Rednote Home Recommendations API のパラメータ

パラメータ必須説明
category任意任意。空でない文字列です。省略した場合は、プロバイダーのマッピングによって homefeed_recommend が設定されます。ここで記載しているバックエンド定義のカテゴリはこれのみで、その他の文字列は確認済みのカテゴリとしては扱っていません。
media_type任意任意の列挙値で、all、image、video のいずれかです。現在のマッピングでは、プロバイダーの画像フラグが設定されるのは image の場合のみで、all と video はどちらも false に対応します。そのため、video を指定しても動画のみのレスポンスになるとは限りません。
results_limit任意任意。1〜40の正の整数です。デフォルトは20で、プロバイダーに要求するページサイズを設定し、明示的に指定した場合は保存される行数の上限にもなります。

Rednote Home Recommendations API の使い方

確認済みの任意の値だけを選んで非同期リクエストを送信し、保存された標準形式の結果を読み取ります。

  1. バックエンドのデフォルト値をそのまま使うか、category、media_type、results_limit を明示的に設定します。
  2. JSONボディを /v1/rednote/home-recommendations に POST し、送信レスポンスの data.task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。next_cursor は、has_more がSocQに保存済みの追加レコードを示す場合にのみ使用します。
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results only

Rednote Home Recommendations API の主なユースケース

  • おすすめページのスナップショット: 件数を絞った公開ホームフィードのページを collected_at とともに取得し、すべてのアイテムを1回の観測に結び付けて管理できます。
  • 編集向けの発見キュー: 正規化された投稿テキスト、投稿者、メディア参照を、人によるレビューや分類のワークフローに取り込めます。
  • 表示コンテンツの監査: 個別に送信したおすすめタスク間で、取得できたメディア構成や公開エンゲージメントのフィールドを比較します。

Rednote Home Recommendations API 活用のヒント

  • プロバイダーのデフォルト値をすべて使う場合は {} を送信してください。公開リクエストのバリデーターで必須となるフィールドはありません。
  • 別のプロバイダーカテゴリを独自に検証していない限り、category は homefeed_recommend のままにしてください。ランタイムは空でない文字列を受け付けますが、カテゴリの列挙値は公開していません。
  • media_type=video は、現在 all と同じプロバイダーフラグに対応しているため注意して扱ってください。フラグが変わるのは image の場合のみです。
  • results_limit は1〜40の範囲で指定し、プロバイダーが要求した件数ちょうどの公開アイテムを返すとは想定しないでください。
  • プロバイダーのカーソルは送信しないでください。上流のエグゼキューターはリクエストを1回だけ実行し、その単一レスポンスから items、notes、feeds を読み取ります。
  • next_cursor は、成功後にSocQに保存済みの結果を続けて読み取るためだけに使用してください。Rednoteの別ページを取得するものではありません。
  • タスク1件につき固定で1.00 SocQクレジットを見込んでください。料金は指定した上限や返されたアイテム数によって変わりません。

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

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

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

Rednote Home Recommendations API — よくある質問

Rednote Home Recommendations APIは、Rednoteの公開ホームおすすめページを1ページ分、正規化された投稿レコードとして取得するAPIです。

必要ありません。サポートされている3つのフィールドはすべて任意で、空のJSONボディを送信した場合は、プロバイダーの homefeed_recommend カテゴリと20件のリクエストサイズが使用されます。

公開バリデーターは空でない category 文字列を受け付けますが、バックエンドが安定したデフォルトとして定義しているのは homefeed_recommend のみです。このページでは、外部調査に基づく追加のカテゴリ値は記載していません。

バリデーターは video を受け付けますが、現在のプロバイダー変換では video と all が同じ false フラグに対応しています。フラグが変わるのは image の場合のみのため、動画のみのレスポンスは保証されません。

できません。プロバイダーへの呼び出しは1ページ分のみです。next_cursor はSocQ共通のタスク結果リーダーに属するもので、完了したタスクにすでに保存されたレコードをページ送りするだけです。

できません。ログイン状態、ユーザーID、アカウント操作、投稿コマンド、モデレーション操作は受け付けません。

タスク1件につき固定で1.00 SocQクレジットです。results_limit や返されるレコード数には左右されません。