POST /v1/videos
Google Videos API
Search Google's Videos tab and get results from YouTube and the rest of the web, with channel, duration, date and thumbnail for each video.
Overview
What the Google Videos API does
The Google Videos API returns Google's Videos tab as JSON. It covers YouTube and other hosts, so one call finds a tutorial whether it lives on YouTube, Vimeo or a vendor's site.
Each result has a resolved link, channel, duration, date, snippet and image_url. Add time=week to see only new uploads.
What you get
-
videos[]array - position, title, link, domain, snippet, image_url, duration, source, channel, date.
-
requestobject - Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
-
metaobject - request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.
Request
curl https://api.serpkite.com/v1/videos \
-H "Authorization: Bearer $SERPKITE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"q":"how to pull an espresso shot","country":"us"}'Response (illustrative, placeholder domains)
{
"request": {
"endpoint": "videos",
"engine": "google",
"q": "how to pull an espresso shot",
"country": "us",
"language": "en",
"page": 1
},
"results": [
{
"position": 1,
"title": "How to Pull the Perfect Espresso Shot (Beginner Guide)",
"link": "https://www.youtube.com/watch?v=abc123xyz00",
"domain": "youtube.com",
"snippet": "Dose, grind, tamp and time: a step-by-step walkthrough for home baristas.",
"image_url": "https://i.ytimg.com/vi/abc123xyz00/hqdefault.jpg",
"duration": "12:48",
"source": "YouTube",
"channel": "Example Coffee Lab",
"date": "Aug 3, 2026"
}
],
"meta": {
"request_id": "req_01J8ZK4M6Q2V7",
"credits_used": 1,
"engine": "google",
"cached": false,
"latency_ms": 812,
"resolved_urls": true,
"parse_quality": "ok"
}
}
Every response also carries X-Credits-Used, X-Credits-Remaining,
X-Cache and X-Tokens-Estimate headers.
Run this query in the playground
Reference
Parameters
The parameters /v1/videos accepts, in the JSON body or the query string.
| Name | Type | Default | Description |
|---|---|---|---|
q
required
|
string | – | The search query. Required. Up to 2,048 characters. |
country
|
string | us | Country to search from, as a two-letter ISO code (us, gb, de, in…). Defaults to the country a location ends in. |
language
|
string | en | Interface language, as a language code with an optional region (en, de, pt-BR, zh-TW…). |
num
|
integer | 10 | Results per call, 1–100. Up to 10 returns one page of 10 (1 credit); above 10 on search and news fetches whole pages as a depth bundle, and 100 costs 7 credits instead of 10. On images a page holds up to 100 images and num (default all) is how many of them come back. |
page
|
integer | 1 | Results page, 1–10. Each page is billed separately. |
time
|
string | – | Restrict to recent results. Shorthand for tbs=qdr:*. Values: hour, day, week, month, year. |
format
|
string | json | Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown. |
fields
|
string | – | Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens. |
max_age
|
integer | – | Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits. |
Full reference, error codes and headers are in the /v1/videos reference. Queue up to 100 requests at half price with POST /v1/batches.
Use cases
What people build with the Google Videos API
Tutorial discovery
Let an agent recommend the best how-to videos for a question.
Video SEO
Track which videos rank for your keywords in Google, not only on YouTube.
Content monitoring
Watch new uploads about your brand or product each week.
Pricing
Google Videos API pricing
Cost per call
1 credit
per page of results
- From $0.60 per 1,000 calls at volume.
- Credits never expire. No subscription.
- Failed, empty and blocked calls are refunded.
- 2,500 free credits = 2,500 calls, then 1,000 credits a month.
For reference: Serper lists Google searches at $1.00 per 1k on its entry tier and $0.30 at its best tier, and its credits expire after 6 months. SerpKite credits cost $1.00 to $0.60 per 1k.
| Pack | Price | Per 1k credits | Per 1k calls | Calls per pack |
|---|---|---|---|---|
| Starter | $10 | $1.00 | $1.00 | 10,000 |
| Growth | $50 | $0.80 | $0.80 | 62,500 |
| Pro | $300 | $0.60 | $0.60 | 500,000 |
FAQ
Google Videos API: common questions
Keep exploring
Related APIs and integrations
Start building
Start with the Google Videos API
2,500 free credits, then 1,000 every month. No credit card.