Google Video Search API: the videos Google shows for a query

{
  "success": true,
  "searchParameters": {
    "q": "how to replace a bike chain",
    "gl": "us",
    "hl": "en",
    "page": 1,
    "pages": 1,
    "num": 10,
    "device": "desktop",
    "type": "serp"
  },
  "videos": [
    {
      "position": 1,
      "title": "How to Replace a Bike Chain in 5 Minutes",
      "url": "https://www.youtube.com/watch?v=abc123xyz00",
      "redirectUrl": null,
      "resolved": true,
      "source": "YouTube",
      "channel": "Example Bike Repair"
    },
    {
      "position": 2,
      "title": "Chain swap for beginners",
      "url": "https://www.tiktok.com/@examplecyclist/video/7300000000000000000",
      "redirectUrl": null,
      "resolved": true,
      "source": "TikTok",
      "channel": "examplecyclist"
    }
  ],
  "peopleAlsoAsk": [
    { "question": "How do I know if my bike chain needs replacing?" }
  ],
  "relatedSearches": [
    { "query": "bike chain replacement cost" }
  ],
  "fetchedAt": "2026-09-29T10:02:41.118Z",
  "cached": false
}

{
  "searchParameters": {
    "q": "how to replace a bike chain",
    "type": "videos",
    "gl": "us",
    "num": 10,
    "page": 1
  },
  "videos": [
    {
      "position": 1,
      "title": "How to Replace a Bike Chain in 5 Minutes",
      "link": "https://www.youtube.com/watch?v=abc123xyz00",
      "thumbnailUrl": "https://i.ytimg.com/vi/abc123xyz00/hqdefault.jpg",
      "duration": "8:42",
      "durationSeconds": 522,
      "source": "Example Bike Repair",
      "sourceUrl": "https://www.youtube.com/@examplebikerepair",
      "publishedDate": "2 years ago",
      "views": "1,204,311 views",
      "viewCount": 1204311,
      "snippet": "Everything you need to swap a worn chain at home…",
      "videoId": "abc123xyz00"
    }
  ],
  "credits": 1
}

# The video results Google shows (3 credits per results page)
curl "https://api.searlo.tech/api/v1/serp?q=how+to+replace+a+bike+chain&gl=us&hl=en&aioverview=false" \
  -H "x-api-key: YOUR_API_KEY"

# Video metadata search (1 credit, up to 10 videos)
curl "https://api.searlo.tech/api/v1/search/videos?q=how+to+replace+a+bike+chain&gl=us&hl=en&limit=10" \
  -H "x-api-key: YOUR_API_KEY"

import requests

API = "https://api.searlo.tech/api/v1"
HEADERS = {"x-api-key": "YOUR_API_KEY"}
query = "how to replace a bike chain"

# 1) Which videos does Google show for the query, and at which position?
serp = requests.get(
    f"{API}/serp",
    params={"q": query, "gl": "us", "hl": "en", "aioverview": "false"},
    headers=HEADERS,
    timeout=120,
).json()
for v in serp["videos"]:
    print(v["position"], v["source"], v["channel"], v["title"], v["url"])

# 2) Duration and views for videos on the topic (1 credit)
vids = requests.get(
    f"{API}/search/videos",
    params={"q": query, "gl": "us", "hl": "en", "limit": 10},
    headers=HEADERS,
    timeout=60,
).json()
for v in vids["videos"]:
    print(v["title"], v["duration"], v["viewCount"], v["link"])

const API = "https://api.searlo.tech/api/v1";
const headers = { "x-api-key": "YOUR_API_KEY" };
const q = "how to replace a bike chain";

const params = new URLSearchParams({ q, gl: "us", hl: "en", aioverview: "false" });
const serp = await fetch(`${API}/serp?${params}`, { headers }).then((r) => r.json());

// Does my channel appear in Google's video block, and where?
const mine = serp.videos.find((v) => v.channel === "Example Bike Repair");
console.log(mine ? `Google video position ${mine.position}` : "Not in Google's video block");