rednote/
search-users

テキストの検索語1つで公開Rednoteアカウントを検索し、プロバイダーの1ページ分から、正規化されたアカウント情報、プロフィール文、アカウントフラグ、表示中のオーディエンス指標を返します。

Rednote Search Users API

テキスト検索語
ソース1ページ分
正規化されたアカウント
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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. 見つけたい公開アカウント、クリエイター名、ブランド、トピックを表す空でない検索語を1つ選びます。
  2. query を /v1/rednote/search-users に送信し、返された task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. 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 only

Rednote 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クレジットを見込んでください。

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

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

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

Rednote Search Users API — よくある質問

Rednote Search Users APIは、テキストの検索語1つから公開Rednoteアカウントを見つけ、正規化されたアカウントレコードを返すAPIです。

必須の空でない query 文字列を1つだけ受け付けます。列挙値、results_limit、プロバイダーのカーソル、並び替え、フィルターのフィールドはサポートされていません。

できません。プロバイダーへの入力は1ページ目に固定されています。共通タスク結果の next_cursor と has_more は、すでに保存されたSocQレコードのページネーションのみを表します。

アカウントスキーマには、アカウントID、ユーザー名、表示名、プロフィール文、公開URL、プロフィール画像、ウェブサイト、認証・非公開フラグ、所在地、表示中のフォロワー数・フォロー数・投稿数のほか、取得可能な場合は取得時のコンテキストが含まれます。

成功したタスク1件につき固定で1.00 SocQクレジットです。結果の件数や任意フィールドの有無には左右されません。