Google Videos
Google's Videos tab for a query: ten videos a page with their site, channel, length and date.
Google's Videos tab for a query: ten videos a page with their site, channel, length and date. Answers the document: search_metadata, search_parameters, search_information (with the result count), videos, related_searches and pagination. Desktop only (device mobile or tablet is a 400). source, Google's video-source filter, is a 400: it has no address a plain page load can send. A result's key moments are not read.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128q*stringWhat to search for.
1 <= lengthlocation?stringA canonical place name, e.g. "Austin,Texas,United States" (becomes Google's uule). Not with uule.
uule?stringGoogle's own location value (w+CAIQ...). Not with location.
gl?stringCountry of the search, two letters.
"us"hl?stringInterface language, e.g. en, pt-br.
"en"device?"desktop"Only desktop: mobile and tablet are a 400.
"desktop""desktop"lr?stringLanguage of the documents, lang_fr or several lang_it|lang_de.
cr?stringCountry of the documents, countryFR or several countryFR|countryDE.
nfpr?string1 leaves out results for an auto-corrected spelling.
"0""0""1"filter?string0 turns off Google's duplicate-content and host-crowding filters.
"1""0""1"safe?stringAdult-content filtering.
"blur""active""blur""off"page?integerResults page; Google's start is (page - 1) * 10.
1 <= value <= 1001time_period?stringOnly videos from this period.
"last_hour""last_day""last_week""last_month""last_year"duration?stringshort (dur:s), medium (dur:m), long (dur:l).
"short""medium""long"quality?"high"high (hq:h): high-definition videos.
"high"captioned?"closed"closed (cc:1): videos with closed captions.
"closed"tbs?stringGoogle's tbs as the caller writes it; not with the filter parameters.
link?stringraw keeps each result link as Google's redirect (https://www.google.com/goto?url=...); resolved follows it to the site's own address (adds time).
"raw""raw""resolved"The results page, as the document. When the page could not be parsed, the usual envelope.
application/json- response
The Videos document. A block is present only when the page has it.
search_metadata?search_parameters?The request as sent, with the defaults that were used.
search_information?videos?array<>related_searches?array<>The tab often has none.
pagination?The page lists no page numbers.
[key: string]?anycurl -X GET 'https://api.justserp.com/v1/google/videos?q=python+tutorial'{ "search_metadata": { "id": "string", "status": "string", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": { "query_displayed": "string", "total_results": 0, "time_taken_displayed": 0 }, "videos": [ { "position": 0, "title": "string", "link": "string", "displayed_link": "string", "snippet": "string", "highlighted": [ "string" ], "length": "string", "date": "string", "source": "string", "channel": "string", "thumbnail": "string" } ], "related_searches": [ { "query": "string", "link": "string" } ], "pagination": { "current": 0, "previous": "string", "next": "string" }}