Rednote Search Users
公開Rednoteアカウントの検索では、テキストの検索語1つに一致するユーザーについて、アカウント情報、プロフィール文、プロフィールのステータス、表示中のオーディエンス数やコンテンツ数を取得できます。正規化されたアカウントレコードは、取得可能なソースフィールドを保持し、collected_at を付与するため、追跡可能な形で発見や比較を行えます。
Rednote Search Users API の主な機能
- 1つの検索語でアカウントを発見空でない query を1つ送信すると、固定の1ページ目に対するプロバイダーのキーワードに対応付けられます。ソースページの制御や追加のフィルターはありません。
- 正規化された公開アカウント情報取得可能なID、ユーザー名、表示名、プロフィール文、公開URL、プロフィール画像、ウェブサイト、認証・非公開の各フィールドを、安定したアカウント形式で受け取れます。
- 表示中のアカウントのスナップショット取得可能なフォロワー数・フォロー数・投稿数を collected_at とともに保持し、返されたすべての値を観測時刻に結び付けます。
Rednote Search Users API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。プロバイダーのキーワードに対応付けられる空でない文字列です。このエンドポイントには、列挙値、results_limit、プロバイダーのカーソル、並び順、メディアフィルターのフィールドはありません。 |
Rednote Search Users API の使い方
アカウント検索語を1つ送信して非同期タスクを追跡し、保存された正規化アカウントレコードを読み取ります。
- 見つけたい公開アカウント、クリエイター名、ブランド、トピックを表す空でない検索語を1つ選びます。
- query を /v1/rednote/search-users に送信し、返された task_id を保存します。
- タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取ります。保存済み結果のレスポンスで has_more が返された場合は、その next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/rednote/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"photography"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results onlyRednote Search Users API の主なユースケース
- クリエイター候補リストの作成: 名前やトピックの語句から公開アカウントを見つけ、候補を選ぶ前に取得可能なアカウント情報とプロフィール文を確認します。
- アカウントディレクトリの補完: 正規化されたID、ユーザー名、表示名、プロフィールテキスト、画像、URL、ウェブサイト、アカウントフラグを発見リストに追加します。
- 公開アカウント指標の比較: 取得可能なフォロワー数・フォロー数・投稿数を取得時点のスナップショットとして使用します。非公開の分析データやリアルタイムの合計値としては扱いません。
Rednote Search Users API 活用のヒント
- 送信するのは query のみにしてください。results_limit、cursor、page、sort、filter、media_type やその他のフィールドは、このエンドポイントで拒否されます。
- プロバイダーへの呼び出しは固定の1ページ目として扱ってください。共通タスクリーダーの next_cursor は、SocQに保存された行をページ送りするもので、Rednoteのソースページを追加で取得するものではありません。
- 公開レスポンスに含まれない場合に備え、ID、ユーザー名、名前、プロフィール文、画像、ウェブサイト、アカウントフラグ、個々の指標が null になることを許容してください。
- 表示中の数値は collected_at とともに保存し、返されるアカウント数にかかわらず、成功したタスク1件につき固定で1.00 SocQクレジットを見込んでください。
関連API
Rednote Search Users API 以外に別の種類の公開Rednoteデータが必要な場合は、これらのAPIをご利用ください。