ソーシャルメディア利用可能

YouTube Search

Search YouTube videos, Shorts, and creator channels with query and region parameters.

各エンドポイントのリクエスト例、パラメータ、1 回あたりの料金を確認できます。1 つの API キーですべて呼び出せます。アカウント制限が適用されます。

API リファレンス Playground で実行

概要

エンドポイント: POST https://api.serpbase.dev/youtube/search
料金: 1 クレジット / リクエスト
認証: X-API-Key
結果タイプ: schemas.source_data

エンドポイントと課金規則

POSThttps://api.serpbase.dev/youtube/search

リクエスト単価

1 クレジット / リクエスト

各リクエストにはカタログの固定料金が適用され、返却ページ数による課金ではありません。Web Crawl と User Agent は現在それぞれ 1 クレジットです。User Agent は無料ではありません。取得元と対象の識別情報で確認された真の不存在は課金対象です。no_results、HTTP 404、hydration や解析データの欠落だけでは不存在を証明できません。実行済みの失敗も課金される場合があり、すべての失敗の返金は保証されません。credits_charged は実際の課金額を示し、0 は報告上のゼロ、null や未指定は不明です。charge_status が UNKNOWN なら数値があっても不明のままです。記録を確認し request_id を添えてサポートへ連絡してください。返金を推測したり無条件に再試行したりしないでください。

リクエストパラメーターの例

例は全パラメーターや必須規則を網羅しません。既知のフィールドは検証され、追加パラメーターは許可されます。

リクエストパラメーターの例
パラメーター	サンプルの型	サンプル値
gl	string	"us"
q	string	"nextjs tutorial"

JSON

{
  "gl": "us",
  "q": "nextjs tutorial"
}

例は全パラメーターや必須規則を網羅しません。既知のフィールドは検証され、追加パラメーターは許可されます。
別名	パラメーター	型
country	locale.country	string
cursor	pagination.cursor	string
device	options.device	string
gl	locale.country	string
hl	locale.language	string
html	include_html	boolean
language	locale.language	string
limit	pagination.limit	integer
markdown	include_markdown	boolean
mobile	options.device	boolean
num	pagination.limit	integer
page	pagination.page	integer
q	query	string
search_query	query	string
sp	attributes.sp	string

対応デバイス：desktop、既定：desktop。

リクエスト例

cURL

curl -X POST 'https://api.serpbase.dev/youtube/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"gl":"us","q":"nextjs tutorial"}'

JavaScript

const response = await fetch("https://api.serpbase.dev/youtube/search", {
  "method": "POST",
  "headers": {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY"
  },
  "body": "{\"gl\":\"us\",\"q\":\"nextjs tutorial\"}"
});
const result = await response.json();
// Check result.status and result.error for the API outcome.
console.log(result);

レスポンスと API の結果

レスポンスは JSON です。HTTP 200 は検索の成功を保証しません。status と error を確認してください。フィールドは製品契約と取得元のデータによって異なります。

レスポンスの説明を見る

よくある質問

YouTube Search API の料金は？

1 リクエストあたり 1 クレジットです。クレジットはプリペイドパックまたは月額プランで購入でき、新規アカウントには無料クレジットが付きます。

YouTube Search API の呼び出し方は？

https://api.serpbase.dev/youtube/search に POST リクエストを送り、X-API-Key ヘッダーに API キーを指定します。応答は JSON で、status（0 は成功）を確認してください。

対応デバイスは？

対応デバイス：desktop。既定値は desktop です。

YouTube Search API は今すぐ使えますか？

はい。有効な API キーで呼び出せます。