Piloterr

Google Videos

Scrape video results from Google Videos search including YouTube, Reddit, and other video platforms, with location and language support.

Credit cost: 1 credit per call

GET
/v2/google/videos

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

The video search query to execute on Google Videos. Supports standard Google search operators.

Examples:

  • paris travel guide — travel videos about Paris
  • machine learning tutorial — educational ML videos
  • site:youtube.com cooking beginner — restrict to YouTube results

Example:

paris travel guide
location?string

City or region from which the video search should originate.

Examples:

  • New York, NY
  • Paris, France
uule?string

Google-encoded location string for precise geographic targeting.

gl?string

Two-letter country code for the Google video search country context.

  • us: United States
  • fr: France
  • gb: United Kingdom
  • de: Germany

Example:

us
Default"us"
hl?string

Two-letter language code for the Google interface language.

  • en: English
  • fr: French
  • de: German
  • es: Spanish

Example:

en
Default"en"
page?number

Page number of video results to retrieve.

  • 1: First page (default)
  • 2: Second page, etc.
Default"1"
num?numberDeprecated

Maximum number of video results to return per page.

  • 10: Default
  • 40: 40 results
  • 100: 100 results
Default"10"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.piloterr.com/v2/google/videos?query=string"

{
  "organic_results": [
    {
      "date": "Jan 23, 2026",
      "link": "https://www.youtube.com/watch?v=pkBQBEtPlHE",
      "title": "The Only Paris Travel Guide You'll Ever Need (2026)",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "Destination Well Known",
      "snippet": "Don't visit Paris before you've watched this complete Paris travel guide I've created the ultimate Paris guide for first-time visitors ...",
      "duration": "26:20",
      "position": 1,
      "video_id": "pkBQBEtPlHE",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "guide",
        "paris",
        "travel"
      ]
    },
    {
      "date": "May 30, 2025",
      "link": "https://www.youtube.com/watch?v=GLKPfHVdYSU",
      "title": "Paris According to Locals | What to Do, See & Eat in Paris",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "The Tour Guy",
      "snippet": "Forget the tired advice from travel guides — here's what locals actually recommend.",
      "duration": "14:02",
      "position": 2,
      "video_id": "GLKPfHVdYSU",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "paris",
        "travel"
      ]
    },
    {
      "date": "Mar 7, 2025",
      "link": "https://www.youtube.com/watch?v=63N38fKU3C0",
      "title": "27 Tips I Wish I Knew Before Visiting Paris",
      "domain": "www.youtube.com",
      "source": "YouTube",
      "channel": "Camden David",
      "snippet": "Here's the exact list I share with friends visiting Paris.",
      "duration": "12:00",
      "position": 3,
      "video_id": "63N38fKU3C0",
      "displayed_link": "www.youtube.com",
      "snippet_matched": [
        "guide",
        "paris",
        "travel"
      ]
    }
  ],
  "search_parameters": {
    "q": "paris travel guide",
    "gl": "us",
    "hl": "en",
    "num": 10,
    "page": 1,
    "uule": null,
    "engine": "google_videos",
    "location": null
  }
}

{
  "error": "Bad Request"
}
{
  "error": "Invalid API Key"
}
{
  "error": "Payment required"
}
{
  "error": "Rate limit exceeded for the API key: quota monthly"
}
{
  "error": "Internal Error"
}