Endpoints · 03/13
Videos
Video results with duration, channel, thumbnail and date.
Endpoint
POSThttps://serp-api.ozymoz.com/videosCredits per call1
Parameters
| Name | Description | Default |
|---|---|---|
qrequired | The search query. | — |
gl | Country to search from, as a two-letter code (us, tr, de…).Default: us | us |
hl | Interface language, as a language code (en, tr, de…).Default: en | en |
num | Number of results per page.Default: 10 | 10 |
page | Results page, starting at 1.Default: 1 | 1 |
tbs | Time filter: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month), qdr:y (year). | — |
device | desktop (default) or mobile — the light page: real links, mobile ranking, no People also ask.Default: desktop | desktop |
resolveLinks | Resolve Google's /goto redirect links to the real URLs (desktop only).Default: true | true |
Example request
curl -X POST 'https://serp-api.ozymoz.com/videos' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"q": "sourdough starter guide",
"gl": "us",
"hl": "en"
}'Example response
Illustrative values in the real shape. Top-level keys: videos.
response.json
{
"searchParameters": {
"type": "videos",
"engine": "google",
"q": "sourdough starter guide",
"gl": "us",
"hl": "en",
"device": "desktop"
},
"videos": [
{
"title": "Sourdough starter from scratch (day by day)",
"link": "https://www.youtube.com/watch?v=xxxxxxxxxxx",
"snippet": "Everything you need to know to keep a starter alive…",
"imageUrl": "https://i.ytimg.com/vi/xxxxxxxxxxx/hqdefault.jpg",
"duration": "12:41",
"source": "YouTube",
"channel": "Example Bakery",
"date": "3 weeks ago",
"position": 1
}
],
"credits": 1
}Good to know
device and resolveLinks work as for search. Non-YouTube links on desktop are resolved from Google's /goto redirects.