Google Videos

Request#

Authenticate with your API key in the x-api-key header (see Authentication).

Body#

JSON object. Unknown fields are rejected with 422.

• glstringdefault us

  Country market (Google gl): results are localized to this country.

  251 allowed values

  ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cu, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, ir, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mf, mg, mh, mk, ml, mm, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sy, sz, tc, td, tf, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, uk, um, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, xk, ye, yt, za, zm, zw

• hlstringdefault en

  Interface language (Google hl).

• locationstring | nullmin length 2, max length 200

  City-level geo-targeting: a Google canonical place name such as Austin,Texas,United States (The standard SERP API location). Encoded into Google's uule (w+ form). Set gl to the place's country. Cannot be combined with uule.

• uulestring | nullmin length 10, max length 1024

  Raw Google uule passthrough (w+... canonical-name or a+... coordinate form), for callers that already encode their own. A w whose + was decoded to a space is accepted. Cannot be combined with location.

• qstringrequiredmin length 1, max length 400

  Video search query (operators such as site:youtube.com work).

• pageintegerdefault 1min 1, max 10

  Result page (10 videos per page).

• safestring | null

  SafeSearch: active filters explicit results, blur (Google's default) blurs them, off shows them.

  One ofactivebluroff

• durationstring | null

  short (<4 min), medium (4-20 min) or long (>20 min) (Google tbs=dur:*).

  One ofshortmediumlong

• time_periodstring | null

  Only results from the last hour/day/week/month/year (Google tbs=qdr:*).

  One oflast_hourlast_daylast_weeklast_monthlast_year

• qualitystring | null

  high keeps high-quality videos only (Google tbs=hq:h).

• captionedstring | null

  closed keeps closed-captioned videos only (Google tbs=cc:1).

• linkstringdefault raw

  raw keeps Google's /goto redirect for non-YouTube results; resolved follows each one (one HTTP request per such result).

  One ofrawresolved

curl -X POST "https://api.scrapercompany.com/v1/google/videos" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "how to make cold brew"
  }'

Response#

200 — One rendered page of Google Videos results with key moments. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

{
  "search_parameters": {
    "engine": "google_videos",
    "q": "how to make cold brew",
    "page": 1,
    "gl": "us",
    "hl": "en"
  },
  "videos": [
    {
      "position": 1,
      "title": "Everything I Learned About Cold Brew Coffee",
      "link": "https://www.youtube.com/watch?v=AB0QLjroFss",
      "displayed_link": "www.youtube.com › watch",
      "snippet": "75g coffee, ground to a fine mokapot or AeroPress setting, or around a 250 micron burr gap. · 1L water suitable for filter coffee, room ...",
      "length": "26:50",
      "source": "YouTube",
      "channel": "James Hoffmann",
      "date": "Oct 1, 2025",
      "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPD",
      "video_id": "AB0QLjroFss",
      "key_moments": [
        {
          "time": "03:02",
          "seconds": 182,
          "title": "Why does cold brew waste coffee?",
          "link": "https://www.google.com/goto?url=CAESbAHrOzAVbC6RLkF4"
        }
      ]
    },
    {
      "position": 2,
      "title": "COLD BREW (concentrate) // one of the most “just let it do its ...",
      "link": "https://www.google.com/goto?url=CAESbAHrOzAVUV1PV-EAZGyB",
      "displayed_link": "www.instagram.com › reel",
      "snippet": "Save this cold brew method. Combine 1 cup of coarse coffee with 4 cups of cold water. Steep for 12-18 hours ...",
      "length": "1:45",
      "source": "Instagram",
      "channel": "Morgan Eckroth",
      "date": "Mar 11, 2026",
      "thumbnail": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD/2wCEAAkGBwgHBgkIBwgKCgkLDRYPD"
    }
  ],
  "related_searches": [
    {
      "query": "how to make cold brew coffee - youtube",
      "link": "https://www.google.com/search?udm=7&q=How+to+make+cold+brew+coffee+-+youtube"
    }
  ],
  "total": 2,
  "meta": {
    "source": "google_videos",
    "wire_bytes": 636122,
    "elapsed_s": 5.1,
    "rendered": true
  }
}

Errors#

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

Try it#

The quickest way: open this endpoint in Try it. It runs on your account with the example request filled in, shows the cost before you run, and shows the answer as a readable table next to the JSON and the code. Signed out? You sign in first and come straight back.

1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? request access).
2. Copy the cURL example above and run it in a terminal.
3. Or open the interactive playground on api.scrapercompany.com, paste your key and pick this endpoint.