Piloterr

Google Videos

GET
/v2/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

Autorisierung

ApiKeyAuth
headerx-api-key<token>

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

Abfrageparameter

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.

google_domain?string

Google domain to use for the search. Defaults to google.com.

Examples:

  • google.com
  • google.co.uk
  • google.fr

Example:

google.com
Default"google.com"
gl?string

Country to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).

Example:

us
Default"us"
hl?string

Language to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).

Example:

en
Default"en"
cr?string

Limit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).

Example:

countryUS
lr?string

Limit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).

Example:

lang_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"
safe?string

Adult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json
  1. response
organic_results?array<>
search_parameters?
Example Request
curl -X GET 'https://api.piloterr.com/v2/google/videos?query=string'
Example Response
{  "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  }}

Google Shopping GET

Zurück

Grainger Product GET

Weiter