Google Videos
Search Google Videos via API and retrieve structured video results with metadata.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringThe search query you want to run on Google Videos.
location?stringHuman-readable location to originate the search from. Note: location and uule cannot be used together.
uule?stringGoogle encoded location parameter. Note: uule and location cannot be used together.
google_domain?stringGoogle domain to use for the search. Defaults to google.com.
Examples:
google.comgoogle.co.ukgoogle.fr
Example:
google.com"google.com"gl?stringCountry 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:
ushl?stringLanguage 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:
encr?stringLimit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).
Example:
countryUSlr?stringLimit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).
Example:
lang_enpage*numberPage number for pagination (1 = first page).
"1"num?numberMaximum number of results per page (e.g. 10).
"10"safe?stringAdult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
organic_results?array<>search_parameters?curl -X GET 'https://api.autom.dev/v1/google/videos?query=string&page=1'{ "organic_results": [ { "date": "3 days ago", "link": "https://www.youtube.com/watch?v=aPrC0eXns9w", "title": "Why Paris Is Extending One Of Its Metro Lines...", "domain": "www.youtube.com", "source": "YouTube", "channel": "The Tim Traveller", "snippet": "Paris is about to open its first urban cable car line.", "duration": "4:19", "position": 2, "video_id": "aPrC0eXns9w" } ], "search_parameters": { "q": "paris", "gl": "us", "hl": "en", "page": 1, "engine": "google_videos" }}