Google Videos Search — API reference

POST

Available

/google/videos/search

Google Videos Search

Search Google video results by query. This discovers video listings, not a video download or watermark-removal service.

type

videos

result

videos

Billing

1 credits

Search Google video results by query. This discovers video listings, not a video download or watermark-removal service.

Parameters

FieldTypeAvailabilityDescription

q

required

string

required

Search query string.

hl

optional

string

optional

Language code. Defaults to en.

gl

optional

string

optional

Country code. Defaults to us.

page

optional

number

optional

1-based page number. Defaults to 1.

query

sample

string

Catalog sample; the API validates required fields.

sample: "how espresso machines work"

json

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

Open in Playground

Response fields

FieldTypeAvailabilityDescription

query

required

string

required

Normalized query from the request.

page

required

number

required

Current 1-based page number.

videos

optional

VideoResult[]

When video results are parsed.

Google Videos results.

VideoResult Result item schema

FieldTypeAvailabilityDescription

rank

required

number

required

1-based ranking position in this response.

position

optional

number

Alias for rank when available.

Normalized rank alias for clients that expect position.

title

required

string

required

Result title.

link

required

string

required

Primary link returned by the parser.

url

optional

string

Present for normalized result links.

Canonical target URL, usually the same value as link.

source_url

optional

string

Only when Google redirect/source URL is observed.

Original Google URL kept for debugging and provenance.

display_url

optional

string

When Google display text or a domain can be derived.

Display URL or source domain.

source

optional

string

When source/channel can be parsed.

Video source or channel label.

duration

optional

string

When duration appears in result text.

Video duration text.

time

optional

string

When posted time can be parsed.

Raw posted time text.

published_at

optional

string

Alias for parsed time when available.

Normalized posted time alias.

thumbnail_url

optional

string

When Google exposes a thumbnail.

Thumbnail URL.

thumbnail

optional

string

Alias for thumbnail_url when available.

Normalized thumbnail alias.

Code and response examples

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"}'

Existing Google request example

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
  }'

Notes

Video search, tutorial discovery, media monitoring.

If no dedicated video cards are parsed, the parser falls back to news-style extraction for compatible Google layouts.