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 の使い方
確認済みの任意の値だけを選んで非同期リクエストを送信し、保存された標準形式の結果を読み取ります。
- バックエンドのデフォルト値をそのまま使うか、category、media_type、results_limit を明示的に設定します。
- JSONボディを /v1/rednote/home-recommendations に POST し、送信レスポンスの data.task_id を保存します。
- タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
- 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 onlyRednote 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クレジットを見込んでください。料金は指定した上限や返されたアイテム数によって変わりません。
関連API
Rednote Home Recommendations API 以外に別の種類の公開Rednoteデータが必要な場合は、これらのAPIをご利用ください。