Outlier ビデオ検索
保存されたデータをキーワード、ニッチ、地域、視聴数とチャンネル登録者数の比率で検索します。
POST
https://api.shortsmonkey.com/v1/videos/outliers/search0 Credits
Outlier ビデオ検索#
保存されたデータをキーワード、ニッチ、地域、視聴数とチャンネル登録者数の比率で検索します。
認証#
Authorization: Bearer sm_live_... を送信します。完全なキーを URL、Cookie、本文、ログ、または分析に決して配置しないでください。
データの鮮度#
ランキングは、ワーカーによって公開された安定したスナップショットを読み取ります。パブリック読み取りによって YouTube リフレッシュがトリガーされることはありません。
リクエスト#
| アイテム | 価値 | 説明 |
|---|---|---|
| 方法 | POST | HTTPリクエストメソッド |
| 完全な URL | https://api.shortsmonkey.com/v1/videos/outliers/search | 生産 API URL |
| 認証 | Authorization: Bearer sm_live_... | ヘッダーのみで完全なキーを送信します |
| コンテンツタイプ | application/json | リクエスト本文は JSON を使用します |
| クレジット | 0 Credits | すべての操作は 0 Credits です。月ごとのクレジット付与や商用クレジットの消費はありません。 |
リクエストパラメータ#
| 名前 | 位置 | タイプ | 必須 | デフォルト | 値または制限 | 説明 |
|---|---|---|---|---|---|---|
keyword | JSON本体 | string | いいえ | — | 1 ～ 120 文字 | 保存されたタイトルまたはニッチなテキストと一致するキーワード |
niche | JSON本体 | string | いいえ | — | 1 ～ 80 文字 | ニッチまたはカテゴリーフィルター |
video_type | JSON本体 | string | いいえ | all | shorts / long / all | ビデオの種類 |
region | JSON本体 | string | いいえ | — | 2 ～ 16 文字 | 地域コード |
max_channel_subscribers | JSON本体 | integer | いいえ | — | 0–10,000,000 | 最大チャンネル登録者数 |
min_views | JSON本体 | integer | いいえ | — | 0–1,000,000,000 | 最小閲覧数 |
min_vs_ratio | JSON本体 | number | いいえ | 10 | 0–100,000 | 視聴者数対チャンネル登録者数の最小比率 |
time_window | JSON本体 | string | いいえ | 7d | 24h / 3d / 7d / 30d | 動画公開ウィンドウ |
limit | JSON本体 | integer | いいえ | 20 | 1–50 | このページのアイテムの最大数 |
all_cursor | JSON本体 | string | いいえ | — | data.all_data.next_cursor | 次のフィルタされていないページをフェッチする |
filter_cursor | JSON本体 | string | いいえ | — | data.filter_data.next_cursor | フィルタを変更せずに次のフィルタされたページを取得します |
cursor | JSON本体 | string | いいえ | — | 非推奨の互換性パラメータ | filter_cursor の別名。両方は送らないでください |
成功の応答フィールド#
all_data は、安定したスナップショットからのフィルタされていないページです。 filter_data は、エンドポイントのデフォルトとリクエスト フィルター後の同じスナップショットからのページです。各結果は個別にページ分割されます。
すべての操作は 0 Credits です。月ごとのクレジット付与や商用クレジットの消費はありません。
| フィールドパス | タイプ | Null可能 | 説明 |
|---|---|---|---|
data.all_data.items | array<object> | いいえ | 現在のページのフィルタされていないビデオ アイテム |
data.all_data.items[].video_id | string | いいえ | YouTube ビデオ ID |
data.all_data.items[].title | string | いいえ | 動画のタイトル |
data.all_data.items[].video_url | string | いいえ | YouTube ビデオ URL |
data.all_data.items[].channel.id | string | はい | チャンネルID |
data.all_data.items[].channel.title | string | いいえ | チャンネルタイトル |
data.all_data.items[].channel.subscribers | integer | はい | 購読者数;非表示時は null |
data.all_data.items[].channel.subscriber_count_hidden | boolean | いいえ | チャンネル登録者数を非表示にするかどうか |
data.all_data.items[].views | integer | いいえ | 閲覧数スナップショット |
data.all_data.items[].views_to_subscribers_ratio | number | はい | 視聴者数対チャンネル登録者数の比率 |
data.all_data.items[].opportunity_score | number | はい | オポチュニティースコア |
data.all_data.items[].duration_seconds | integer | いいえ | 動画の長さ (秒) |
data.all_data.items[].published_at | string(date-time) | はい | UTC ISO 8601 でのビデオ公開時間 |
data.all_data.items[].snapshot_at | string(date-time) | はい | データ収集時間 |
data.all_data.items[].niche | string | はい | ニッチまたはカテゴリー |
data.all_data.items[].track | string | はい | データセット トラック識別子 |
data.all_data.items[].region | string | はい | 地域コード |
data.all_data.items[].reasons | array<string> | いいえ | ランキングの理由 |
data.all_data.items[].video_type | string | いいえ | shorts または long |
data.all_data.next_cursor | string | はい | この結果セットの次のページ cursor。終了時はnull |
data.filter_data.items | array<object> | いいえ | デフォルトとリクエストフィルター後のビデオアイテム |
data.filter_data.items[].video_id | string | いいえ | YouTube ビデオ ID |
data.filter_data.items[].title | string | いいえ | 動画のタイトル |
data.filter_data.items[].video_url | string | いいえ | YouTube ビデオ URL |
data.filter_data.items[].channel.id | string | はい | チャンネルID |
data.filter_data.items[].channel.title | string | いいえ | チャンネルタイトル |
data.filter_data.items[].channel.subscribers | integer | はい | 購読者数;非表示時は null |
data.filter_data.items[].channel.subscriber_count_hidden | boolean | いいえ | チャンネル登録者数を非表示にするかどうか |
data.filter_data.items[].views | integer | いいえ | 閲覧数スナップショット |
data.filter_data.items[].views_to_subscribers_ratio | number | はい | 視聴者数対チャンネル登録者数の比率 |
data.filter_data.items[].opportunity_score | number | はい | オポチュニティースコア |
data.filter_data.items[].duration_seconds | integer | いいえ | 動画の長さ (秒) |
data.filter_data.items[].published_at | string(date-time) | はい | UTC ISO 8601 でのビデオ公開時間 |
data.filter_data.items[].snapshot_at | string(date-time) | はい | データ収集時間 |
data.filter_data.items[].niche | string | はい | ニッチまたはカテゴリー |
data.filter_data.items[].track | string | はい | データセット トラック識別子 |
data.filter_data.items[].region | string | はい | 地域コード |
data.filter_data.items[].reasons | array<string> | いいえ | ランキングの理由 |
data.filter_data.items[].video_type | string | いいえ | shorts または long |
data.filter_data.next_cursor | string | はい | この結果セットの次のページ cursor。終了時はnull |
meta.request_id | string | いいえ | リクエストトレースID |
meta.snapshot_id | string | いいえ | 安定したスナップショット ID |
meta.snapshot_at | string(date-time) | いいえ | スナップショットのタイムスタンプ |
meta.data_status | string | いいえ | データセットのステータス |
credits.cost | integer | いいえ | すべての操作は 0 Credits です。月ごとのクレジット付与や商用クレジットの消費はありません。 |
credits.remaining | integer | null | はい | null |
credits.period_ends_at | string(date-time) | null | はい | null |
credits.unlimited | boolean | いいえ | true |
ページネーションと cursor#
all_data.next_cursor を all_cursor として送信し、filter_data.next_cursor を filter_cursor として送信します。 cursor は独立しており、不透明で、署名されており、24 時間有効です。従来の cursor は、filter_cursor のエイリアスにすぎません。
Eタグ#
ランキングはIf-None-Matchをサポートしています。ヒットすると、HTTP 304 と X-Credits-Cost: 0 が返されます。
エラーとレート制限#
すべてのエラーには、code、安定した英語の message、request_id、および details が含まれます。すべての 4xx/5xx 応答にはクレジットがかかりません。
| HTTP ステータス | コード | 原因 | 推奨されるアクション |
|---|---|---|---|
| 400 | INVALID_REQUEST | パラメータの形式、組み合わせ、または範囲が無効です | details.issues を使用してパラメータを修正します |
| 401 | INVALID_API_KEY | キーが無効または非アクティブです | Bearer ヘッダーとキーのステータスを確認する |
| 429 | API_DAILY_LIMIT_REACHED | 同じアカウントの API キーは 1 日 10 回の REST データ呼び出し枠を共有します。Asia/Shanghai の 00:00 にリセットされます。ウェブサイトの検索は別枠で 1 日 10 回です。MCP はどちらの枠も消費しません。 | REST データ呼び出しが 10 回に達すると、HTTP 429 と API_DAILY_LIMIT_REACHED を返します。Asia/Shanghai の翌 00:00 までお待ちください。キーの作成やローテーションでは枠はリセットされません。 |
| 429 | RATE_LIMITED | レートまたは同時実行の制限を超えました | Retry-After 間隔後に再試行します |
| 503 | DATA_STALE / SERVICE_UNAVAILABLE | データまたはサービスが一時的に利用できない | 後で再試行し、request_id を保持します |
curl -X POST "https://api.shortsmonkey.com/v1/videos/outliers/search" \
-H "Authorization: Bearer $SHORTSMONKEY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"finance","video_type":"all","time_window":"7d","min_vs_ratio":10,"limit":20}'