Google Videos Scraper API is a tool that allows users to extract videos from Google Videos search results in a structured format. The API returns a HTML or JSON object that contains the search results and additional metadata about the search or CSV.
HTML
JSON Example
{
"request_info" : {
"success" : true,
"monthly_credits_limit" : 80000,
"monthly_credits_remaining" : 62717,
"monthly_credits_reset_at" : "2023-05-03T06:40:06.000Z",
"topup_credits_remaining" : 0,
"credits_decremented_from" : "monthly_credits",
"credits_used_this_request" : 1
},
"search_parameters" : {
"q" : "chocolate milk",
"location" : "United States",
"google_domain" : "google.com",
"gl" : "us",
"hl" : "en",
"search_type" : "videos",
"engine" : "google",
"output" : "json"
},
"search_metadata" : {
"created_at" : "2023-04-10T15:13:47.887Z",
"processed_at" : "2023-04-10T15:13:49.742Z",
"total_time_taken" : 1.85,
"engine_url" : "https://www.google.com/search?q=chocolate+milk&gl=us&hl=en&uule=w+CAIQICINVW5pdGVkIFN0YXRlcw&tbm=vid",
"html_url" : "https://app.scrapein.app/api/v1/google/videos?q=chocolate+milk&location=United+States&google_domain=google.com&gl=us&hl=en&api_key={API-KEY}&search_type=videos&engine=google&output=html",
"json_url" : "https://app.scrapein.app/api/v1/google/videos?q=chocolate+milk&location=United+States&google_domain=google.com&gl=us&hl=en&api_key={API-KEY}&search_type=videos&engine=google&output=json",
"location_auto_message" : "We have automatically set the 'google_domain', 'gl' and 'hl' parameters to match the supplied location of 'United States'. You can stop this behaviour by setting the 'location_auto' parameter to 'false'."
},
"search_information" : {
"original_query_yields_zero_results" : false,
"total_results" : 38000000,
"time_taken_displayed" : 0.28
},
"related_searches" : [
{
"query" : "chocolate milk recipe",
"link" : "https://www.google.com/search?gl=us&hl=en&tbm=vid&q=Chocolate+milk+recipe&sa=X&ved=2ahUKEwiW5v2SzZ_-AhVvkmoFHY0oAwEQ1QJ6BAgYEAE",
"type" : "standard"
},
{
"query" : "hot chocolate milk recipe",
"link" : "https://www.google.com/search?gl=us&hl=en&tbm=vid&q=Hot+chocolate+milk+recipe&sa=X&ved=2ahUKEwiW5v2SzZ_-AhVvkmoFHY0oAwEQ1QJ6BAgMEAE",
"type" : "standard"
}
],
"pagination" : {
"current" : 1,
"next" : "https://www.google.com/search?q=chocolate+milk&gl=us&hl=en&tbm=vid&ei=rCc0ZJbgHO-kqtsPjdGMCA&start=10&sa=N&ved=2ahUKEwiW5v2SzZ_-AhVvkmoFHY0oAwEQ8NMDegQIGRAW",
"other_pages" : [
{
"page" : 2,
"link" : "https://www.google.com/search?q=chocolate+milk&gl=us&hl=en&tbm=vid&ei=rCc0ZJbgHO-kqtsPjdGMCA&start=10&sa=N&ved=2ahUKEwiW5v2SzZ_-AhVvkmoFHY0oAwEQ8tMDegQIGRAE"
},
{
"page" : 10,
"link" : "https://www.google.com/search?q=chocolate+milk&gl=us&hl=en&tbm=vid&ei=rCc0ZJbgHO-kqtsPjdGMCA&start=90&sa=N&ved=2ahUKEwiW5v2SzZ_-AhVvkmoFHY0oAwEQ8tMDegQIGRAU"
}
],
"api_pagination" : {
"next" : "https://app.scrapein.app/api/v1/google/videos?q=chocolate%20milk&location=United%20States&google_domain=google.com&gl=us&hl=en&api_key={API-KEY}&search_type=videos&output=json&id=req0&page=2",
"other_pages" : [
{
"page" : 2,
"link" : "https://app.scrapein.app/api/v1/google/videos?q=chocolate%20milk&location=United%20States&google_domain=google.com&gl=us&hl=en&api_key={API-KEY}&search_type=videos&output=json&id=req0&page=2"
},
{
"page" : 10,
"link" : "https://app.scrapein.app/api/v1/google/videos?q=chocolate%20milk&location=United%20States&google_domain=google.com&gl=us&hl=en&api_key={API-KEY}&search_type=videos&output=json&id=req0&page=10"
}
]
}
},
"video_results" : [
{
"position" : 1,
"title" : "Homemade Chocolate Milk Recipe - The Spruce Eats",
"link" : "https://www.thespruceeats.com/chocolate-milk-recipe-2355494",
"domain" : "www.thespruceeats.com",
"displayed_link" : "www.thespruceeats.com › ... › Non-Alcoholic Drinks",
"image" : "<data:image/jpeg;base64>"
},
{
"position" : 10,
"title" : "Whole Chocolate Milk - Rutter's Dairy",
"link" : "https://www.ruttersdairy.com/products/rutters-milk/whole-chocolate-milk/",
"domain" : "www.ruttersdairy.com",
"displayed_link" : "www.ruttersdairy.com › Rutter’s Milk",
"date" : "Sep 23, 2020",
"date_utc" : "2020-09-23T00:00:00.000Z",
"image" : "https://i.ytimg.com/vi/wDEKvNv_hrk/mqdefault.jpg?sqp=-oaymwEFCLIBEGQ&rs=AMzJL3lIszVVmhCND-5wmrL3ncikAcc84g"
}
]
}
JSON Structure
The JSON structure returned by the Google Videos Scraper API includes required elements, such as request_info, search_parameters, search_metadata, search_information, pagination, as described in the Results SERP Google API section, as well as those specific to Google Videos, which are described below.
Here is a description of each parameter in the JSON response from the ScrapeIN Google Videos API.
related_searches
The related_searches is an array of objects that represent related searches shown at the bottom of the video results page. Each related search object has the following properties:
query: the keywords / search term of the related search.link: a link to the Google search URL for the related search.
video_results
The video_results is an array of objects that represent the video results returned by the API. Each video result object has the following properties:
position: the position of the video result on the current page.title: the title of the video result.link: a link to the video result.domain: the domain of the link to the video result.displayed_link: the displayed (visual) link shown next to the video result.date: the raw date, if shown, of the video result.date_utc: the parsed date, in ISO 8601 format, of the video result. Note that date parsing relies on the API being able to successfully parse the date and isn't guaranteed in all locales.snippet: the snippet text of the video result.image: the thumbnail image of the video result, either returned as a URL to the image, or as a Base64-encoded image string.length: the runtime of the video, expressed in the form minutes:seconds.