rednote/
search-notes

テキストの検索語で公開Rednoteノートを検索し、並び順・メディア・期間の任意フィルターを指定して、正規化されたコンテンツ、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

Rednote Search Notes API

キーワードでノート検索
並び順とメディアのフィルター
公開データの1ページ分スナップショット
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Rednote Search Notes

Rednoteのノート検索結果は、キーワードに一致した公開投稿で、ノートID、テキスト、投稿者情報、メディア、公開日時、表示中のエンゲージメントを含みます。これらのレコードは、トピック調査、フォーマットの比較、ソースの確認、特定時点の検索結果分析に活用できます。

Rednote Search Notes API の主な機能

  • 3種類のフィルターを備えたキーワード検索テキストの検索語1つに加え、対応する並び順、メディア種別、公開期間を選択して、対象を絞った公開ノート検索を定義できます。
  • 正規化されたノートIDとコンテンツノートID、公開URL、テキスト、リソース種別、公開日時、取得日時を共通の PostItem 構造で返します。
  • 投稿者、メディア、表示中のエンゲージメント取得可能な公開投稿者フィールド、画像または動画の参照、ハッシュタグ、メンション、表示中のいいね数・コメント数・シェア数・再生数を保持します。
  • 範囲を限定したソース検索ページタスクごとに選択した検索の1ページ目を1回実行します。複数ページにわたる網羅的なソースクロールではなく、範囲の明確なスナップショットを生成します。

Rednote Search Notes API のパラメータ

パラメータ必須説明
query必須必須。公開Rednoteノートの検索に使う空でないテキストです。Playgroundでは、独自の検索語を入力するまで空欄のままです。
sort_by任意任意。結果の並び順で、general、latest、most_liked のいずれかです。Playgroundの初期値は general です。
media_type任意任意。ノート形式のフィルターで、all、image、video のいずれかです。Playgroundの初期値は all です。
published_within任意任意。公開期間のフィルターで、all、day、week、six_months のいずれかです。Playgroundの初期値は all です。

Rednote Search Notes API の使い方

Rednoteの検索語と任意のフィルターを送信して非同期タスクを追跡し、保存されたノートレコードをSocQのカーソルページネーションで読み取ります。

  1. 空でない query を用意し、sort_by、media_type、published_within にはサポートされている値のみを選択します。
  2. ペイロードを /v1/rednote/search-notes に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を返すまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor をたどります。これは保存済みの結果をページ送りするもので、Rednoteの検索ページを追加で取得するものではありません。
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$REDNOTE_SEARCH_QUERY\",\"sort_by\":\"general\",\"media_type\":\"all\",\"published_within\":\"all\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Rednote Search Notes API の主なユースケース

  • キーワード検索結果のカタログ化: ノートID、公開URL、テキスト、投稿者の参照、collected_at を使い、特定の検索語について追跡可能なスナップショットを作成します。
  • 画像と動画の検索結果比較: media_type を変えてそれぞれ実行し、得られたスナップショット間で返されたメディア参照、ノートのテキスト、表示中のエンゲージメントを比較します。
  • 新しさを重視したトピック確認: latest の並び順や公開期間のフィルターを published_at、collected_at と組み合わせ、1つのトピックについて最近表示されたノートを確認します。
  • 投稿者のコンテキスト分析: 一致したノートのテキストやメディアを取得可能な投稿者情報フィールドと関連付け、検索スナップショットにどの公開アカウントが現れるかを分析します。

Rednote Search Notes API 活用のヒント

  • 必須フィールドの検証でタスクが拒否されないよう、送信前に query の前後の空白を除去し、空でないことを確認してください。
  • 記載されている列挙値のみを使用してください。明示的に設定したうえで最も広い範囲を検索したい場合は、general、all、all を選択します。
  • 各タスクはソース検索1ページ分として扱い、スナップショットが後続のソースページまで含むとは想定せず、フィルターの組み合わせごとに別のタスクを実行してください。
  • 保存されたスナップショットがSocQの結果ページで複数ページにわたる場合は、has_more が false になるまで next_cursor をたどってください。このカーソルがRednoteの別のソースページを要求することはありません。
  • 取得時刻によって並び順や表示中の指標が異なる場合があるため、別々の検索実行結果を照合する際はノートIDとURLを使用してください。
  • テキスト、投稿者フィールド、メディア、公開日時、ハッシュタグ、メンション、個々の指標は null になり得るものとして扱い、公開テキストは表示前にエスケープしてください。

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

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

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

Rednote Search Notes API — よくある質問

Rednote Search Notes APIは、テキストの検索語1つと、任意の並び順・メディア種別・公開期間フィルターを使って公開Rednoteノートを検索し、正規化されたノートID、テキスト、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。

query は必須です。sort_by は general、latest、most_liked、media_type は all、image、video、published_within は all、day、week、six_months を受け付けます。

デフォルトの例では、query に 旅行攻略、sort_by に general、media_type に all を使用し、published_within は省略しています。このエンドポイントは results_limit、ページ番号、ソースのカーソルを受け付けません。

各 PostItem には、ノートID、URL、テキスト、投稿者の詳細、メディア、公開日時と取得日時のタイムスタンプ、ハッシュタグ、メンション、表示中のいいね数・コメント数・シェア数・再生数が含まれる場合があります。任意のソース値は、取得できない場合 null のままになります。

できません。各タスクはソースの1ページ目を1回だけ要求します。next_cursor は、SocQにすでに保存された結果の次のページを読み取るだけで、タスク結果の limit は1〜500、デフォルトは50です。

タスク1件につき固定で1 SocQクレジットです。保存または返されるノートの件数によって、この固定のタスク料金が変わることはありません。