Google Videos Search — API リファレンス

POST

利用可能

/google/videos/search

動画検索

Google の動画一覧を検索します。動画のダウンロードや透かし除去は提供しません。

type

videos

result

videos

課金

1 credits

Google の動画一覧を検索します。動画のダウンロードや透かし除去は提供しません。

パラメータ

フィールド型出現条件説明

q

必須

string

必須

検索クエリ文字列。

hl

任意

string

任意

言語コード。デフォルトは en。

gl

任意

string

任意

国コード。デフォルトは us。

page

任意

number

任意

1 始まりのページ番号。デフォルトは 1。

query

例

string

カタログの例。必須項目は API が検証します。

例: "how espresso machines work"

json

{
  "query": "how espresso machines work"
}

Playground で実行

レスポンスフィールド

フィールド型出現条件説明

query

必須

string

必須

リクエストから正規化されたクエリ。

page

必須

number

必須

現在の 1 始まりのページ番号。

videos

任意

VideoResult[]

動画結果が解析された場合。

Google 動画検索結果。

VideoResult 結果アイテム構造

フィールド型出現条件説明

rank

必須

number

必須

このレスポンス内の 1 始まりの順位。

position

任意

number

利用可能な場合は rank のエイリアス。

position を期待するクライアント向けの正規化順位。

title

必須

string

必須

結果タイトル。

link

必須

string

必須

parser が返す主リンク。

url

任意

string

結果リンクを正規化できる場合に返ります。

正規化されたターゲット URL。通常は link と同じです。

source_url

任意

string

Google のリダイレクト元 URL がある場合のみ返ります。

デバッグと出所確認のために保持される元の Google URL。

display_url

任意

string

Google の表示テキストまたはドメインを取得できる場合。

表示 URL またはソースドメイン。

source

任意

string

出典・チャンネルを解析できる場合。

動画の出典・チャンネル名。

duration

任意

string

結果テキストに長さが含まれる場合。

動画の長さのテキスト。

time

任意

string

投稿時刻を解析できる場合。

投稿時刻の原文。

published_at

任意

string

解析時刻があればその別名。

正規化された投稿時刻の別名。

thumbnail_url

任意

string

Google がサムネイルを公開している場合。

サムネイル URL。

thumbnail

任意

string

利用可能な場合は thumbnail_url のエイリアス。

正規化されたサムネイルエイリアス。

コードとレスポンスの例

bash

curl -X POST 'https://api.serpbase.dev/google/videos/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"how espresso machines work"}'

既存の Google リクエスト例

bash

curl -X POST https://api.serpbase.dev/google/videos/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio tutorial",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'

注記

動画検索、チュートリアル発見、メディア監視。

専用の動画カードがなければ、対応する Google レイアウトでニュース形式の抽出を試みます。