POST /videos
Google Videos API
The BestSERP Google Videos API returns the results of Google's Videos tab as JSON: title, link, duration, channel, platform, upload date and a short description for each video. It lists videos from many sites, not only one platform, in any country and language.
Last updated:
Key takeaways
- /videos returns videos with title, link, snippet, duration, channel and more.
- Target any country with gl and any language with hl; city-level location is not supported yet.
- 1 credit per page of results ($0.50 per 1,000 after 3,000 free); failed searches are refunded.
- POST a JSON body or GET with the same parameters; the key goes in the X-API-KEY header.
Try the Google Videos API
Pick a suggested query to see a saved response, or type your own for a live search (3 free per day).
Loading the live demo
Send a request
POST a JSON body to
https://api.bestserp.com/videos with your key in the X-API-KEY header. Replace YOUR_API_KEY and run.curl -X POST 'https://api.bestserp.com/videos' \
-H 'X-API-KEY: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"q":"python asyncio tutorial"}'Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
qrequired | string | Search query (1–256 characters). | |
gl | string | us | Country, 2-letter code (us, gb, vn, de…). The search runs from an IP in that country when one is free, else from another one (see ipCountry). |
hl | string | en | Interface language (en, vi, de…). |
num | integer | 10 | Maximum results per page: 10, 20, 30, 40 or 50 (Google may return fewer, e.g. 8 or 9 of 10). Each 10 costs 1 credit. |
page | integer | 1 | Page to return, 1–5 (page × num/10 ≤ 5). Pages 1…page are fetched and charged. |
tbs | string | Recency: qdr:h (hour), qdr:d (day), qdr:w (week), qdr:m (month), qdr:y (year). Also accepted: timeRange = hour|day|week|month|year. | |
includeThumbnails | boolean | false | Include inline base64 thumbnails (~20 KB each). |
noCache | boolean | false | Skip the 1-hour result cache (5 minutes for news). |
async | boolean | false | Answer 202 immediately with a requestId to poll. |
timeout | number | 60 | Seconds to wait before answering 202 (1–120). |
autocorrect | boolean | Accepted for compatibility; no effect. |
Response fields
Results are in
videos. Empty fields are left out.videos[]
| Field | Meaning |
|---|---|
position | Rank of the video, from 1. |
title | Video title. |
link | Video page URL. |
snippet | Description shown under the title, when there is one. |
duration | Length as displayed, e.g. 12:41. |
channel | Channel or uploader. |
platform | Site hosting the video, e.g. YouTube. |
date | Upload date as displayed. |
imageUrl | Thumbnail as an inline data: URI, only with includeThumbnails: true (about 20 KB each). |
Every response
| Field | Meaning |
|---|---|
searchParameters | Your request after validation, with defaults filled in (q, gl, hl, type, page or pages...). |
requestId | ID of this request. Poll GET /requests/{requestId} for async requests and for final links. |
credits | Credits charged for this request (refunded automatically if it fails). |
cached | true when the answer came from the recent-result cache (1 hour, 5 minutes for news). |
linksPending | true while Google redirect links are being replaced by final URLs; poll the request to get them. |
unresolvedLinks | Links that are still Google redirects: they work, but are not the final URL. |
durationMs | Time the search took, in milliseconds. |
ipCountry | Country of the IP the search ran from (same code as gl). Another country than gl when no IP there was free: the search runs anyway instead of waiting. Missing when unknown. |
Sample response
A trimmed response for "python asyncio tutorial". Your results reflect Google at the time of the request.
{
"searchParameters": {
"q": "python asyncio tutorial",
"gl": "us",
"hl": "en",
"type": "videos",
"num": 10,
"page": 1,
"engine": "google"
},
"videos": [
{
"position": 1,
"title": "Python asyncio in 20 minutes",
"link": "https://www.youtube.com/watch?v=asyncio20m",
"snippet": "Event loops, tasks and gather, explained with examples.",
"duration": "20:14",
"channel": "Code Simply",
"platform": "YouTube",
"date": "3 weeks ago"
},
{
"position": 2,
"title": "Async Python: the complete guide",
"link": "https://www.youtube.com/watch?v=asyncguide",
"snippet": "From coroutines to structured concurrency.",
"duration": "1:02:45",
"channel": "Dev Academy",
"platform": "YouTube",
"date": "2 months ago"
},
{
"position": 3,
"title": "asyncio vs threads: which is faster?",
"link": "https://www.youtube.com/watch?v=asyncvsthr",
"snippet": "We benchmark both on I/O-bound workloads.",
"duration": "12:08",
"channel": "Bench Bytes",
"platform": "YouTube",
"date": "5 days ago"
}
],
"requestId": "5b0c8a52-3f0e-4d55-9a2a-0f3a8e2d1c11",
"credits": 1,
"cached": false,
"linksPending": false,
"unresolvedLinks": 0,
"durationMs": 1710
}What you can build
Video SEO
See which videos rank for your keywords and on which platforms.
Content research
Find tutorials, reviews and talks on a topic across video sites.
AI assistants
Let an assistant suggest videos with links and durations.
AI assistants guide
Current limits
What this API does not do yet, so you can decide before you build on it.
- Duration, channel and date are strings as Google displays them; no view counts.
- Video thumbnails are returned only with includeThumbnails: true.
- Up to 5 pages per request (page x num/10 <= 5); each page costs 1 credit.
- Targeting is by country (gl) and interface language (hl). City-level location is not supported yet: a request with location is refused with an explicit error.
- Results are what a desktop browser sees. There is no mobile SERP option yet.
- 60 searches per minute per account by default; ask on Telegram for more.
Pricing: 1 credit per page of results, 3,000 free credits, then $0.50 per 1,000. See pricing
Frequently asked questions
Is this only YouTube?
No. It returns Google's Videos tab, which lists videos from many sites; platform tells you where each one is hosted.
Do I get view counts?
No. Each video has its title, link, duration, channel, platform and date as displayed, plus a description when Google shows one.
Can I get thumbnails?
Yes, send includeThumbnails: true to receive each thumbnail as an inline data: URI (about 20 KB each).
Can I find recent videos only?
Yes, with tbs: qdr:d, qdr:w, qdr:m or qdr:y (or timeRange).
Other Google APIs
- Google Search APIOrganic results with titles, links and snippets, plus the video carousel and Top stories.
- Google Images APIImage results with full-size image URLs, dimensions and the page that hosts each image.
- Google News APINews articles with source, publish time and site icon, from the Google News tab.
- Google Shopping APIProducts with price, numeric price, discount, delivery and rating.
- Google Places APILocal businesses with rating, category, address and opening hours.
- Google Maps APIGoogle Maps places with coordinates, place id and CID.
Start with 3,000 free searches
No credit card. Sign in with Google, create a key, send your first request.