Skip to content

New Official SDKs for TypeScript, Python and Go

SerpKite
Get API key
Docs menu / Google Videos

Google Videos

Video results with channel, duration, date and thumbnail.

POST https://api.serpkite.com/v1/videos Credits: 1 per page Try in playground
View as Markdown

Google Videos results with channel, duration, publish date and thumbnail.

Request body

Send a JSON object with Content-Type: application/json. The same parameters also work as a query string on GET /v1/videos. JSON arrays are rejected: to run many queries at once, use POST /v1/batches at half price. Unknown parameters return 400 invalid_request with a message that names the replacement; see strict validation.

ParameterTypeDefaultDescription
q requiredstringThe search query. Required. Up to 2,048 characters.
countrystringusCountry to search from, as a two-letter ISO code (us, gb, de, in…).
languagestringenInterface language, as a language code (en, de, fr, pt-BR…).
numinteger10Results per call. 10 per page; 100 fetches the top 100 as a depth bundle for 7 credits instead of 10. One of: 10, 20, 30, 50, 100.
pageinteger1Results page, 1–10. Each page is billed separately.
timestringRestrict to recent results. Shorthand for tbs=qdr:*. One of: hour, day, week, month, year.
tbsstringRaw Google tbs filter, e.g. qdr:w or cdr:1,cd_min:…
formatstringjsonResponse format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. One of: json, compact, markdown.
fieldsstringComma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
max_ageintegerAccept a cached result up to this many seconds old. Cache hits cost 50% of the credits.
enginestring or arraygoogleWhich search providers may answer. google is Google only (SerpKite still fails over across its own proxy pools); auto falls back to other providers when Google is blocked or times out; consensus (search only) asks several independent indexes in parallel, merges the results by URL, ranks them by agreement and lists each result's sources, at the sum of one page per provider that returned results; a provider name or a list (e.g. google,brave) restricts the request to those. meta.engine names the provider that answered. One of: google, auto, consensus, brave, bing, yahoo, duckduckgo, mojeek, wikipedia.

Example request

Authenticate with Authorization: Bearer $SERPKITE_API_KEY (GET requests may pass ?api_key= instead). The official SDKs read SERPKITE_API_KEY for you. See Authentication. 

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 fields

FieldTypeDescription
requestobjectThe normalised request, with defaults filled in: endpoint, engine, q, country, language, location, num, page, device, autocorrect…
results[]arrayposition, title, link, domain, snippet, image_url, duration, source, channel, date.
metaobjectrequest_id, credits_used, cached, cached_at, engine (the provider that answered), route (provider attempts, see Search providers), latency_ms, parse_quality (ok, partial, empty), resolved_urls.

Every billed response also carries credit and latency headers (X-Credits-Used, X-Credits-Remaining, X-Request-Id…).

Example response

200 OK · illustrative 
{
  "request": {
    "endpoint": "videos",
    "engine": "google",
    "q": "how to pull an espresso shot",
    "country": "us",
    "language": "en"
  },
  "results": [
    {
      "position": 1,
      "title": "How to pull the perfect espresso shot",
      "link": "https://video.example.com/watch?v=abc123",
      "domain": "video.example.com",
      "snippet": "Dose, grind, tamp and time: a step-by-step guide…",
      "image_url": "https://video.example.com/thumb/abc123.jpg",
      "duration": "8:42",
      "source": "Example Video",
      "channel": "Home Barista Lab",
      "date": "Mar 3, 2026"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "cached": false,
    "engine": "google",
    "latency_ms": 1034,
    "parse_quality": "ok",
    "resolved_urls": true
  }
}

Errors

Errors use one shape: {"error":{"code","message","request_id"}}. Errors are never billed. Full list in Errors.

StatusCodeMeaning
400invalid_requestA parameter is missing or invalid.
401unauthorizedThe API key is missing, invalid or revoked.
402insufficient_creditsYour balance is too low. Buy a pack or wait for the monthly free grant.
429rate_limitedToo many requests per second for your plan. Retry after the Retry-After header.
503upstream_errorGoogle could not be fetched or parsed. Not billed; retry after Retry-After.