The google_search source is designed to retrieve Google Search results (SERPs). This sub-page specifically presents information related to Google Web Search. To explore other result types, read Image SearchorNews Search.
Request samples
In the samples below, we make a request to get 2 results pages, from number 11 to number 12 , for search term adidas on google.nl domain. The SERP will be filtered to contain French-language results only. API will return parsed results.
Basic setup and customization options for scraping Google Web search results.
- mandatory parameter
Google Advanced Search Operators
When scraping, you might find it useful to combine Google advanced search operators with your query. It enables you to customize the scope of the search, ensuring that the results are more relevant and focused. Explore these special commands here and here. See an example below.
Adapt search results to specific geographical locations, domains, and languages.
Pagination
Controls for managing the pagination and retrieval of search results.
Continuous scroll support
Web Scraper API fully supports Google Search continuous scroll. It automatically detects continuous scrolling layouts, efficiently loading the requested organic results without any extra parameters required.
Limit per page
To use this feature, include a JSON array with JSON objects containing the following data:
Options to filter and refine search results based on various criteria. Learn how to use context parameters here.
udm and tbm context parameters cannot be used together in a single scraping request; please select only one. Using both simultaneously may lead to conflicts or unexpected behavior.
Other
Additional advanced settings and controls for specialized requirements.
Context parameters
All context parameters should be added to the context array as objects with key and value pairs, e.g.:
..."context": [ {"key":"filter","value":"0" }]...
Structured data
Web Scraper API is capable of extracting either an HTML or JSON object that contains Google search results, offering structured data on various elements of the results page.
google_search structured output
{"results": [ {"content": {"url":"https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en","page":1,"results": {"pla": {"items": [ {"pos":1, "url": "https://www.adidas.com/us/nmd_r1-primeblue-shoes/GZ9257.html?dfw_tracker=24819-GZ9257-0010",
"price":"$150.00","title":"NMD_R1 Primeblue Shoes Black M 8.5 / W 9.5 - Mens Originals Shoes","seller":"adidas", "url_image": "https://encrypted-tbn1.gstatic.com/shopping?q=tbn:ANd9GcSZALnENHKXERktsOCnUSscRd4v0cSUw9E0XPaZwgyruM0Wuw-MhWcchAVzZRBdS-OP3_167R3jCg&usqp=CAc",
"image_data":"iVBORw0KGgoAAAANSUhE...JRU5ErkJggg==" }, ... {"pos":22, "url": "https://www.adidas.com/us/ultraboost-5.0-dna-shoes/GY6452.html?dfw_tracker=24819-GY6452-0006",
"price":"$90.00","title":"Ultraboost 5.0 DNA Shoes Magic Grey 13K - Kids Originals Shoes","seller":"adidas", "url_image": "https://encrypted-tbn3.gstatic.com/shopping?q=tbn:ANd9GcSTCgTZ1im_6ZX9YSCrjQfjVEnTmpmiqqYAHAhXzA9VhJdrokOeOnWsbEOxqA8zPkaos192xPF5ogA&usqp=CAc",
"image_data":"iVBORw0KGgoAAAANSUhEU...kJggg==" } ],"pos_overall":1 },"paid": [],"images": {"items": [ {"alt":"Image result for adidas","pos":1,"url":"/search?q=adidas&gl=us&h...E#imgrc=Dw-CBW17i8BqsM","source":"https://www.britannica.com/topic/Adidas-AG" }, ... {"alt":"Image result for adidas","pos":10, "url": "/search?q=adidas&gl=us&hl=en&tbm=isch&sourXRM%252Cvz-MIh...QF6BAhLEAE#imgrc=_oOH_rR4W_-X-M",
"source":"https://www.shutterstock.com/search/adidas" } ],"pos_overall":11 },"organic": [ {"pos":1,"url":"https://www.adidas.com/us", "desc": "adidas is about more than sportswear and workout clothes. We partner with the best in the industry to co-create. This way we offer our fans the sporting goods, ...",
"title":"adidas Official Website | adidas US","sitelinks": {"expanded": [ {"url":"https://www.adidas.com/us/women","title":"Women" }, ... {"url":"https://www.adidas.com/us/sale","title":"Sale" } ] },"url_shown":"https://www.adidas.com› ...","pos_overall":2 }, ... {"pos":5,"url":"https://play.google.com/store/apps/details?id=com.adidas.app&hl=en_US&gl=US", "desc": "YOUR ADIDAS - MORE THAN A SHOPPING APP The home of sport and sneakers, the adidas app puts you closer to the action with access to sneaker drops, ...Size: 115MUpdated: May 3, 2022 Rating: 4.8 · 322,391 votes · Free · Android · Sports",
"title":"adidas - Apps on Google Play","url_shown":"https://play.google.com› store › apps › details › id=com....","pos_overall":12 } ],"twitter": {"pos":1,"url":"https://twitter.com/adidas","items": [ {"pos":1, "url": "https://twitter.com/adidas/status/1521901157064531968?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
"content":"What do you like to listen to most during workouts?","timeframe":"5 days ago" }, ... {"pos":3, "url": "https://twitter.com/adidas/status/1519345069366652928?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
"content":"How would you describe your favorite sport to an alien?","timeframe":"Apr 27, 2022" } ],"title":"","pos_overall":7 },"knowledge": {"title":"Adidas","factoids": [ {"title":"Customer service chat","content":"Online Chat" }, ... {"title":"Website","content":"http://www.adidas-group.com/" } ],"profiles": [ {"url":"https://www.instagram.com/adidas","title":"Instagram" }, ... {"url":"https://www.youtube.com/user/adidas","title":"YouTube" } ],"subtitle":"Design company", "description": "Adidas AG is a German multinational corporation, founded and headquartered in Herzogenaurach, Bavaria, that designs and manufactures shoes, clothing and accessories. It is the largest sportswear manufacturer in Europe, and the second largest in the world, after Nike.",
"related_searches": [ { "url": "/search?gl=us&hl=en&q=Nike&si=AC1wQDCwN61-ebmuwbQCO5QCrgOvEq5bkWeIzJ5JczItzAKNdbIxoHfFJ8UFY3e1CorwNJXI6gTWniM6aVu3nEoseblyAI-5N39_1F3DTWWABELjIdJa9ZgI_g5n-c9ZUZdzEZeV2VGOkDNPl5DwiBeyifKPveoCnBsiT3wVpKdr52FPqK5rzQSzspA-sjztjVcZy2WfOwFITo5EfSXyZ5AsknO1X-dzXUCOlIIGCvFWqi9OKgK5PaWp7EcXls7n8Ag_L7HC3Pgg2k5FWR631X7Hvi1268shAg%3D%3D&sa=X&ved=2ahUKEwiLlsjE8dH3AhUQkGoFHT2IBUQQxA16BAhdEAU",
"title":"Nike" }, ... { "url": "/search?gl=us&hl=en&q=Asics&si=AC1wQDDagiMg03ncxeOQZbwVe-CJxRCchC-jr2hCPTxjc9wbgNZ1pCnWqLo_0N5RPhArBCY1qCgzESLe6Y9hB2HKnzquQNjJW9iLV6gQvDXzTwkl6LZHjq2aOuZII0W5uCWjpc0oOVU5JzyOjRUNEYoe_N_KsbL4xn4A0Fl2S4JMYAeaBZmu8jPX8EFVl_C3gerS4CRTyrfcL2bL-VhUNLEXVUlkFxrLlAyeZfUMVYSDo4WqV1c8-Bgp-rBwBzqW73Q7s1kOZHBtCQ8aBNfbfulPCljSG9vXBrcj9RqQRA8pD8TlH1rz8qE%3D&sa=X&ved=2ahUKEwiLlsjE8dH3AhUQkGoFHT2IBUQQxA16BAhdEAs",
"title":"Asics" } ] },"top_stories": {"items": [ {"pos":1,"url":"https://www.adidas.com/us/adilette-comfort-slides/GZ5898.html","title":"adidas Adilette Comfort Slides - Beige | women swim | adidas US","source":"","timeframe":"8 hours ago" }, ... }, {"pos":3,"url":"https://www.adidas.com/us/women-clothing-sale","title":"Women's Clothing Sale Up to 50% Off | adidas US","source":"","timeframe":"Sep 30, 2021" } ],"pos_overall":3 },"instant_answers": [ {"type":"unknown","_parsed":false,"pos_overall":5 }, ],"popular_products": {"items": [ {"pos":1,"title":"Adidas Yeezy Kids Foam Runner","image_data":"UklGRhwJAABXRUJQVlA...rAZNVIAAA" }, ... {"pos":10,"title":"Adidas Men's Kaptir 2.0","image_data":"UklGRhQNAAB...+wTh1cLB/uQAAAAAAAAA=" } ],"pos_overall":4 },"related_searches": {"pos_overall":14,"related_searches": ["adidas shoes","adidas yeezy","adidas outlet","adidas pants","adidas sneakers","adidas superstar","adidas wikipedia" ] },"search_information": {"query":"adidas","showing_results_for":"adidas","total_results_count":1440000000 },"total_results_count":1440000000,"related_searches_categorized": [ {"category": {"name":"Adidas logo","type":"collapsed" },"pos_overall":13 } ] },"last_visible_page":10,"parse_status_code":12000 },"created_at":"2022-05-09 07:24:16","updated_at":"2022-05-09 07:24:20","page":1,"url":"https://www.google.com/search?q=adidas&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en","job_id":"6929330182268395521","status_code":200,"parser_type":"v2" } ]}
The composition of elements may differ based on whether it was a desktop or mobile search.
To help you identify certain elements, refer to the data dictionaries for each type of Google search result, whether obtained from desktop or mobile searches.
Output data dictionary
Navigate through the details using the right-side navigation or scrolling down the page.
HTML example
JSON structure
The Google Web Search structured output includes fields like URL, page, results, and others. The table below presents a detailed list of each SERP feature we parse, along with its description and data type. The table also includes some metadata.
The number of items and fields for a specific result type may vary depending on the search query.
In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.
Product Listing Ads (PLA)
The pla section of search results refers to Product Listing Ads, also known as Google Shopping Ads, prominently displayed at the top of the search page in a carousel format.
The paid section refers to advertisements powered by Google Ads, usually appearing above organic (non-paid) results.
..."paid": [ {"pos":1,"url":"https://www.adidas.com/us/cyber_monday", "desc": "Last Chance For Cyber Deals. Extra 45% Off Sale & Full Price Products With Code CYBERSALE. Shop The adidas\u00ae Official Site Today. Join Our adiClub Loyalty Program. Members Only Rewards. adiClub Exclusives.",
"title":"adidas Official Website | Extra 45% Off | Code CYBERSALE","data_rw":"https://www.google.com/aclk?...","sitelinks": {"expanded": [ {"url":"https://www.adidas.com/us/shop","desc":"Last Chance For Cyber Deals. Extra 45% Off With Code CYBERSALE.","title":"Cyber Monday Sale" }, {"url":"https://www.adidas.com/us/shoes","desc":"Find The Right Shoes Today. Sport & Lifestyle Shoes Available Online.","title":"adidas\u00ae Shoes" }, {"url":"https://www.adidas.com/us/ultraboost","desc":"Incredible Energy Return Shop The New Ultraboost\u2122 Light Today.","title":"adidas\u00ae Ultraboost\u2122 Light" }, {"url":"https://www.adidas.com/us/nmd","desc":"Shop The Latest NMD Shoe Releases By adidas Originals Online Today.","title":"adidas\u00ae NMD" } ] },"url_shown":"https://www.adidas.com \u203a official \u203a site","pos_overall":1 }]...
Images
The images section refers to image results displayed in different sections on a SERP page, either as a dedicated section or at the top. It's important to note that the structure of scraped data from Google Search results may differ from that of scraped data from Google Image Search results.
The organic section refers to unpaid listings in organic Google search results, determined by relevance through Google's algorithm. These listings appear below paid ads on search pages.
..."organic": [ {"pos":1,"url":"https://www.loveandlemons.com/brownies-recipe/", "desc": "The best brownie recipe! Made with cocoa powder and chocolate chips, these homemade brownies are fudgy, gooey, super chocolaty, and easy to make!",
"title":"Best Homemade Brownies Recipe","images": ["/9j/4AAQSkZJRgABAQAAAQABAAD/..." ],"sitelinks": {"inline": [ {"url":"https://www.loveandlemons.com/recipes/vegetarian-recipes/","title":"Vegetarian Recipes" }, {"url":"https://www.loveandlemons.com/baking-recipes/","title":"25 Super Fun Baking Recipes" }, {"url":"https://www.loveandlemons.com/oatmeal-cookies/","title":"Perfect Oatmeal Cookies" } ] },"url_shown":"https://www.loveandlemons.com\u203a Recipes","pos_overall":2 },...
Organic Videos
The results.organic_videos contains an array of video listings that are displayed organically in the search results, meaning they are not paid advertisements. Each video listing includes relevant details such as the video title, URL, description.
..."organic_videos": [ {"pos":1,"url":"https://www.youtube.com/watch?v=XHTrLYShBRQ","desc":"Your browser can't play this video. Learn more.","title":"Introducing iPhone 15 | WOW | Apple - YouTube","pos_overall":6 },...
Top Sights
The results.top_sights contains a list of prominent landmarks or attractions typically associated with the search location or topic. Each item includes details such as the position in the list and title.
The results.jobs contains job listings extracted from the search results. Each listing includes details such as the URL directing to the job posting, job title, source, employer, and location. The listings are sourced from various job boards, career websites, and other platforms indexed by Google.
The twitter feature frequently surfaces for brands, movies, musicians, and other celebrities, typically positioned directly under the search result for the brand's website. This feature offers a direct link to the brand's Twitter feed, showcasing a carousel of its most recent tweets.
..."twitter": {"pos":1,"url":"https://twitter.com/NintendoAmerica","items": [ {"pos":1, "url": "https://twitter.com/NintendoAmerica/status/1729311652984623440?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
"content": "You can now redeem your #MyNintendo Platinum Points to collect holiday themed custom icons, available until 12/25 at 5pm PT. #NintendoSwitchOnline #MissionsAndRewards\n\nLearn more: ninten.do/6017iHF1b",
"timeframe":"12 hours ago" }, ... ],"title":"Nintendo of America (@NintendoAmerica) \u00b7 X","pos_overall":4},...
Knowledge
The knowledge section within search results shows Google Knowledge Panel data on the right side when searching for people, places, organizations, or entities integrated into the Knowledge Graph.
..."knowledge": {"title":"Adidas","images": ["iVBORw0KGgoAAAANSUhEUgAAAHcAAABUCAMAAACP31ggAAAAY1BMVEX/..." ],"factoids": [ {"links": [ {"href":"/search?safe=off&sca_esv=586315320...","title":"Founder" }, {"href":"/search?safe=off&sca_esv=586315320...","title":"Adolf Dassler" } ],"title":"Founder","content":"Adolf Dassler" }, ... ],"profiles": [ {"url":"https://www.instagram.com/adidas","title":"Instagram" }, ... ],"subtitle":"Apparel company", "description": "DescriptionAdidas AG is a German athletic apparel and footwear corporation headquartered in Herzogenaurach, Bavaria, Germany. It is the largest sportswear manufacturer in Europe, and the second largest in the world, after Nike. Wikipedia",
"related_searches": [ {"url":"/search?safe=off&sca_esv=586315320...","title":"Nike","section_title":"People also search for" }, ... ]},...
Local Pack
The local_pack displays the top three local search results based on the user's location or specified search location, including a map and additional information.
top_stories is a dedicated section surfacing in Google Search for news-oriented queries.
..."top_stories": {"items": [ {"pos":1, "url": "https://www.independent.co.uk/arts-entertainment/films/news/elon-musk-leave-the-world-behind-b2462401.html",
"title":"Netflix users mock 'triggered' Elon Musk over Leave the World Behind \ncomplaint11 hours ago","source":"The Independent","timeframe":"11 hours ago" }, ... ],"pos_overall":3},...
Popular Products
The popular_products SERP feature presents a carousel of various products determined by their popularity and relevance to the user's query. This differs from Product Listing Ads (PLAs), which are influenced by advertisers. It's worth noting that multiple popular_products carousels may appear on a single SERP page.
The related_searches SERP feature displays alternative search queries related to the initial search keyword, typically located at the bottom of the SERP.
..."related_searches": {"pos_overall":12,"related_searches": ["tesla model 3","tesla car price","tesla model y","tesla owner","tesla - wikipedia","tesla cybertruck","tesla 2023","tesla logo" ]},...
Related Questions
The related_questions feature is positioned below the main search results, presenting a list of questions directly related to the user's original search query. By offering a curated set of related questions, users can explore different aspects of their topic, enhancing their overall search experience.
..."related_questions": {"items": [ {"pos":1, "answer": "According to Guinness World Records as of 1995, the Bible is the best selling book of all time with an estimated 5 billion copies sold and distributed.",
"source": { "url": "https://en.wikipedia.org/wiki/List_of_best-selling_books#:~:text=According%20to%20Guinness%20World%20Records,billion%20copies%20sold%20and%20distributed.",
"title":"List of best-selling books - Wikipedia","url_shown":"Wikipediahttps://en.wikipedia.org \u203a wiki \u203a List_of_best-selling_..." },"question":"Which book is No 1 in the world?" }, ... ],"pos_overall":2},...
Search Information
The search_information feature provides structured information on the search query.
..."search_information": {"query":"restaurants","geo_location":"10007, New York, NY","showing_results_for":"restaurants","total_results_count":3200000000},...
Item Carousel
A carousel (item_carousel) of images or links related to a specific type of item is displayed at the very top of the SERP. The content and layout vary based on the user's search query, showcasing a selection of relevant items. This can range from products and news to images, creating a visually engaging and tailored experience for users.
The videos feature in Google's Search Engine Results Page displays a curated selection of video content related to a user's search query, including thumbnails, titles, and source information.
..."videos": {"items": [ {"pos":1,"url":"https://www.youtube.com/watch?v=xFrGuyw1V8s","title":"Abba - Dancing Queen (Official Music Video Remastered)","author":"AbbaVEVO","source":"YouTube" }, {"pos":2,"url":"https://www.youtube.com/watch?v=-crgQGdpZR0","title":"ABBA - Take A Chance On Me (Official Music Video)","author":"AbbaVEVO","source":"YouTube" },... ],"pos_overall":4},...
Featured Snippet
The featured_snippet is a unique Google search result where a concise snippet describing a page is shown before a link to that page. These highlighted results are prominently displayed at the top of the organic search results, providing users with quick access to relevant information.
..."featured_snippet": [ {"url":"https://www.fs.usda.gov/visit/fall-colors/science-of-fall-colors", "desc": "As night length increases in the autumn, chlorophyll production slows down and then stops and eventually all the chlorophyll is destroyed. The carotenoids and anthocyanin that are present in the leaf are then unmasked and show their colors.",
"title":"Science of Fall Colors | US Forest Service","url_shown":"https://www.fs.usda.gov\u203a visit \u203a science-of-fall-colors","pos_overall":1 }],...
Related Searches Categorized
related_searches_categorized specifically showcases searches related to lists. Unlike general related searches, which encompass all user queries, this feature provides a focused set of list-related queries. Typically found at the bottom of the search results page, it serves as a targeted source of keywords related to the primary search term.
..."related_searches_categorized": [ {"items": [ {"url":"/search?sca_esv=589812617...","title":"Bayerische Motoren Werke AG" }, {"url":"/search?safe=off&sca_esv=588766249...","title":"Mercedes..." }, ... ],"category": {"name":"Electric car companies","type":"expanded" },"pos_overall":10 },...
Hotels
Google hotels is a feature that showcases hotel information directly within the search results. When users search for hotels or accommodation-related queries on Google, the search engine may present a dedicated hotel module at the top of the results page, offering a convenient and prominent overview of relevant options.
..."hotels": {"date_to":"Mon, 11 Dec","results": [ {"price":"£54","title":"Hilton Garden Inn Vilnius City Centre","description":"Modern hotel with a restaurant/bar" }, {"price":"£57","title":"Radisson Blu Hotel Lietuva","description":"Modern high-rise with a spa & dining" }, ... ],"date_from":"Sun, 10 Dec","pos_overall":5},...
Flights
The flights feature presents a block containing organized flight options associated with a relevant search query, allowing users to compare options directly in the search results.
..."flights": {"to":"London, United Kingdom (all airports)","from":"New York, NY (all airports)","date_to":"Mon, Jan 29","results": [ { "url": "https://www.google.com/travel/flights?safe=off&sca_esv=590053957&source=flun&uitype=cuAA&hl=en&gl=us&curr=USD&tfs=CAEQAhotEgoyMDI0LTAxLTIyMgJaMGoNCAISCS9tLzAyXzI4NnIMCAISCC9tLzA0anBsGi0SCjIwMjQtMDEtMjkyAlowagwIAhIIL20vMDRqcGxyDQgCEgkvbS8wMl8yODZ6aENqUklUVmxrYjA1V2RubE9kazFCUkRSM2RrRkNSeTB0TFMwdExTMHRMWGxzWm5FeU9FRkJRVUZCUjFZMFNrMXpTVXhTTTJ0QkVnTnVXakFhQ3dpOHlnSVFBaG9EVlZORU9EQnd2TW9D",
"type":"Nonstop","price":"$423","airline":"Norse Atlantic UK","duration":"6h 50m" }, ... ],"date_from":"Mon, Jan 22","pos_overall":1},...
Video Box
The video_box feature highlights a specific video result at the top of the search results page, chosen by Google as the most relevant for the query.
..."video_box": {"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","title":"Rick Astley - Never Gonna Give You Up (Official Music Video)","pos_overall":1},...
Local Service Ads
The local_service_ads feature empowers service-oriented professionals, such as plumbers, electricians, locksmiths, and other local providers, to promote their services on the Google Search results page.
The apps SERP feature displays relevant applications based on the user's query, providing key details such as price, rating, and more. This feature serves as a valuable platform for app developers and publishers to enhance the visibility and engagement of their mobile applications directly on the Google Search results page.
Device type and browser. The full list can be found here.
desktop
geo_location
The geographical location that the result should be adapted for. Using this parameter correctly is extremely important to get the right data. For more information, read about our suggested geo_location parameter structures here.
-
domain
Domain localization for Google. The full list of available domains can be found here.
com
locale
Accept-Language header value which changes your Google search page web interface language. More info.
-
context:
results_language
Results language. List of supported Google languages can be found here.
Learn how to use context parameters here.
-
start_page
Starting page number.
1
pages
Number of pages to retrieve.
1
limit
Number of results to retrieve in each page.
10
context:limit_per_page
Scrape multiple pages using the same IP address and session (cookie set). By specifying the page numbers in a JSON array with the page key and indicating the number of organic results per page using the limit key, you can minimize the chance of seeing overlapping organic results across pages (e.g., the last organic result on the first page being the same as the first organic result on the second page). See example.
-
page
The number of the page you would like to scrape. Any integer value greater than 0 will work
1
limit
The number of results on the page in question. Any integer value between 1 and 100 (inclusive) will work.
90
context:
filter
Setting the value of this parameter to 0 lets you see results that would otherwise be excluded due to similarity to other results.
1
context:
safe_search
Safe search. Set to true to enable it.
false
context:
udm
udm parameter allows switching between different search tabs, such as images, places, or videos, to customize the type of results displayed. Find the accepted values here.
This parameter is like a container for more obscure google parameters, like limiting/sorting results by date as well as other filters some of which depend on the tbm parameter (e.g. tbs=app_os:1 is only available with tbm value app). More info here.
-
context:
fpstate
Setting the fpstate value to aig will make Google load more apps. This parameter is only useful if used together with the render parameter.
-
context:
nfpr
true will turn off spelling auto-correction
false
url
The URL of the Google search page.
string
page
Page number relative to the Google SERP pagination.
integer
results
A dictionary containing the results of the search.
object
results.pla
A list of product listing ads with their respective details.
object
results.paid
A list of sponsored results with their respective details.
array
results.images
A list of image results with their respective details.
object
results.flights
A list of flights with their respective details.
object
results.organic
A list of unpaid listings with their respective details.
array
results.organic_videos
A list of organic videos with their respective details.
array
results.top_sights
A list of notable landmarks or attractions with their respective details.
array
results.jobs
A list of jobs listings with their respective details.
object
results.local_service_ads
A list of sponsored local service providers.
object
results.video_box
A single video item with its respective details.
object
results.recipes
A list of recipes with their respective details.
object
results.twitter
A list of Twitter (X) results with their respective details.
array
results.knowledge
A list of relevant information retrieved from the knowledge panel.
object
results.local_pack
A list containing local business listings relevant to the search.
object
results.item_carousel
A list of illustrative items for informational queries with their respective details.
object
results.videos
A list of videos with their respective details.
object
results.related_searches_categorized
A list of related searches that other people have done.
array
results.hotels
A list of hotels relevant to the location used in the search query.
object
results.apps
A list of applications with their respective details.
array
results.finance
A summary of financial data for companies, including stock prices, market cap, and other key metrics.
object
results.sports_games
Information on recent sports games, detailing scores, teams, game types, and highlights.
object
results.discussions_and_forums
A list of discussion threads and forum posts with URLs, titles, sources, and comment counts.
object
results.featured_snippet
A list of specific results retrieved from the organic part of SERPs.
array
results.top_stories
A list of articles with their respective details when a search query is identified as news-oriented.
object
results.popular_products
A list of unpaid and organic displays of Google Shopping product listings with their respective details.
object
results.related_searches
A list of related searches presented at the bottom of the search page.
object
results.related_questions
A list of related interrogative search queries with their respective details.
object
results.search_information
A list of details for the submitted search query.
object
total_results_count
The total number of results found for the search query.
string
last_visible_page
Value identifying the maximum page number visible in the search query results page. (-1 when loading of more results is initiated by scrolling).
integer
parse_status_code
The status code of the parsing job. You can see the parser status codes described here.
integer
created_at
The timestamp when the scraping job was created.
timestamp
updated_at
The timestamp when the scraping job was finished.
timestamp
job_id
The ID of the job associated with the scraping job.
string
status_code
The status code of the scraping job. You can see the scraper status codes described here.
integer
parser_type
The type of the parser used for breaking down the HTML content.
string
items
All PLAs available within the page.
array
Desktop and Mobile
items.pos
An indicator denoting the position of a given item among PLA results.
integer
Desktop and Mobile
items.url
The URL of the product.
string
Desktop and Mobile
items.price
The price of the product in the listing ad.
string
Desktop and Mobile
items.title
The title of the product in the listing ad.
string
Desktop and Mobile
items.seller
The seller of the product in the listing ad.
string
Desktop and Mobile
items.url_image
The URL of the product image.
string
Desktop
items.image_data
The base64-encoded thumbnail image of the product.
string
Desktop and Mobile
pos_overall
An indication of the position of the PLA SERP feature within the SERP.
integer
Desktop and Mobile
pos
An indicator denoting the position of a given item among paid results.
integer
Desktop and Mobile
url
The URL of the paid result.
string
Desktop and Mobile
desc
A short description of the paid result.
string
Desktop and Mobile
title
The title of the paid result.
string
Desktop and Mobile
data_rw
Redirect URL of the paid result.
string
Desktop and Mobile
sitelinks
An object containing information about internal links to a website that appears under the first search result on Google.
object
Desktop and Mobile
sitelinks.inline/expanded
A list of URLs with their respective details. The name of the key (`inline`/`expanded`) specifies the type of the sitelinks element.
array
Desktop and Mobile
sitelinks.inline.url
The URL of the linked site.
string
Desktop and Mobile
sitelinks.inline.title
The title of the linked site.
string
Desktop and Mobile
sitelinks.inline.description
A short description of the linked site.
string
Desktop
url_shown
The short-hand URL visible just below the description.
string
Desktop and Mobile
pos_overall
An indication of the position of the paid result within the SERP.
integer
Desktop and Mobile
items
A list of images with their respective details.
array
Desktop and Mobile
items.alt
The alt text of the image.
string
Desktop and Mobile
items.pos
A unique indicator denoting the image position in the list.
integer
Desktop and Mobile
items.url
The URL of the web page containing the image.
string
Desktop and Mobile
pos_overall
An indication of the position of the Images SERP feature within the SERP.
integer
Desktop and Mobile
pos
An indicator denoting the position of a given item among organic results.
integer
Desktop and Mobile
url
The URL of the organic result.
string
Desktop and Mobile
desc
A short description of the organic result.
string
Desktop and Mobile
title
The title of the organic result.
string
Desktop and Mobile
images
The base64-encoded thumbnail images of the organic result.
string
Desktop and Mobile
sitelinks
Object contains `expanded` or `inline` element with more details on the sitelinks.
object
Desktop and Mobile
sitelinks.expanded/inline
A list of sitelinks of the organic result. The name of the key (inline/expanded) specifies the type of the sitelinks element.
array
Desktop and Mobile
sitelinks.expanded.url
The URL of the linked site.
string
Desktop and Mobile
sitelinks.expanded.title
The title of the linked site.
string
Desktop and Mobile
url_shown
The short-hand URL visible just below the description.
string
Desktop and Mobile
pos_overall
An indication of the position of the Organic result within the SERP.
integer
Desktop and Mobile
pos
An indicator denoting the position of a given item among Organic Videos results.
integer
Desktop
url
The URL of the video.
string
Desktop
desc
Short description of the video.
string
Desktop
title
The title of the video.
string
Desktop
pos_overall
An indication of the position of the Organic Video result within the SERP.
integer
Desktop
items
A list of top attractions with their respective details.
array
Desktop
items.pos
The position of the Top Sights result within the Top Sights SERP feature.
integer
Desktop
items.title
The title of the tourist attraction site.
string
Desktop
pos_overall
An indication of the position of the Top Sights result within the SERP.
integer
Desktop
listings
An array of all jobs listings available within the page.
array
Desktop
listings.url
The URL to the full job listing.
string
Desktop
listings.title
The title of the job position.
string
Desktop
listings.source
The source which contains the original job posting.
string
Desktop
listings.employer
The organization hiring for the identified position.
string
Desktop
listings.location
The location for the position.
string
Desktop
pos_overall
An indication of the position of the Jobs SERP feature within the SERP.
integer
Desktop
pos
An indicator denoting the position of a given item among organic results.
integer
Desktop
url
The URL of the profile containing the Twitter (X) posts.
string
Desktop
items
A list of Twitter (X) posts with their respective details.
array
Desktop
items.pos
An indicator denoting the position of a given tweet within the Twitter (X) SERP feature.
string
Desktop
items.url
The URL of the Twitter (X) post.
string
Desktop
items.content
A short description denoting all of the text from the relevant Twitter (X) post.
string
Desktop
items.timeframe
Describes how long ago the tweet was created.
string
Desktop
title
The title of the Twitter (X) profile.
string
Desktop
pos_overall
An indication of the position of the Twitter result within the SERP.
integer
Desktop
title
The title of the knowledge panel.
string
Desktop and Mobile
images
A list of images used right next to the title.
array
Desktop
factoids
A list of all the facts used in the knowledge panel.
array
Desktop and Mobile
factoids.links
A list of all the links related to a given factoid item.
array
Desktop and Mobile
factoids.links.href
A hyperlink to the Google Search results page for the given factoid.
string
Desktop and Mobile
factoids.links.title
The description of any linked pages related to the factoid.
string
Desktop and Mobile
factoids.title
The name of the factoid section.
string
Desktop and Mobile
factoids.content
The description of the factoid.
string
Desktop and Mobile
profiles
A list of social media profiles listed in the knowledge panel.
string
Desktop
profiles.url
A link to the social media profile.
string
Desktop
profiles.title
The title of the social media profile.
string
Desktop
subtitle
A short explanation about the entity described in the title.
string
Desktop and Mobile
description
A description denoting main information about the entity in the knowledge panel.
string
Desktop and Mobile
related_searches
A list of related searches with their respective details.
array
Desktop
related_searches.url
The URL of the related search page.
string
Desktop
related_searches.title
The title of the related search page.
string
Desktop
related_searches.section_title
The name of the related search section.
string
Desktop
items
A list of locations with their respective details.
array
Desktop and Mobile
items.cid
A unique identification number assigned to a specific business listing.
string
Desktop and Mobile
items.pos
The position of the local result within the local pack.
integer
Desktop and Mobile
items.title
The title of the local entity.
string
Desktop and Mobile
items.rating
The rating of the local entity.
integer
Desktop and Mobile
items.address
The address of the local entity.
string
Desktop and Mobile
items.rating_count
The number of ratings for the local entity.
integer
Desktop and Mobile
pos_overall
An indication of the position of the Local Pack result within the SERP.
integer
Desktop and Mobile
items
A list of selected news articles with their respective details.
array
Desktop and Mobile
items.pos
The position of the article within the Top Stories SERP feature.
integer
Desktop and Mobile
items.url
The URL to the full article.
string
Desktop and Mobile
items.title
The title of the article.
string
Desktop and Mobile
items.section
The name of the Top Stories section.
string
Mobile
items.source
The name of the site where the article is published.
string
Desktop and Mobile
items.timeframe
Describes how long ago the article was published.
string
Desktop
pos_overall
Indicates the overall position of the Top Stories SERP feature within the SERP.
integer
Desktop and Mobile
items
A list of popular products with their respective details.
array
Desktop and Mobile
items.pos
A unique indicator denoting the position of a given popular product within the Popular Products SERP feature.
integer
Desktop and Mobile
items.price
The price of a given popular product.
string
Desktop and Mobile
items.title
The title of a given popular product.
string
Desktop and Mobile
items.rating
The rating of a given popular product.
string
Desktop
items.seller
The seller of a given popular product.
string
Desktop
items.image_data
The base64-encoded thumbnail image of the product.
string
Desktop
pos_overall
Indicates the overall position of the Popular Products SERP feature within the SERP.
integer
Desktop and Mobile
pos_overall
Indicates the overall position of result type within the search page.
integer
Desktop and Mobile
related_searches
A list of related search strings.
array
Desktop and Mobile
items
A list containing all of the related questions.
array
Desktop and Mobile
items.pos
A unique indicator denoting the position of any given related question within the Related Questions SERP feature.
integer
Desktop and Mobile
items.answer
The answer to the related question.
string
Desktop and Mobile
items.source
Contains values describing the source of the answer to the question.
object
Desktop and Mobile
items.source.url
The URL of the site which is used to obtain the answer.
string
Desktop
items.source.title
The title of the site which contains the answer.
string
Desktop
items.source.url_shown
The short-hand URL visible just below the answer.
string
Desktop and Mobile
items.question
The question from the related questions section.
string
Desktop and Mobile
pos_overall
Indicates the overall position of the Related Questions SERP feature within the SERP.
integer
Desktop and Mobile
query
The original search term.
string
Desktop and Mobile
geo_location
*Works only with JS rendering
Indicates the specific geographical area associated with the search.
string
Desktop
showing_results_for
The search term the search results are shown for. `query` and `showing_results_for` may differ if Google auto-corrected the provided search term.
string
Desktop and Mobile
total_results_count
The total number of results found for the search term.
integer
Desktop and Mobile
items
A list of items placed in a carousel with their respective details.
array
Desktop
items.pos
The position of the item within the carousel.
integer
Desktop
items.href
A hyperlink to the Google SERP of the item in the carousel.
string
Desktop
items.title
The name/title of the entity in the carousel.
string
Desktop
items.subtitle
Additional details about the entity in the title.
string
Desktop
title
The title of the carousel section. The title is related to the search query.
string
Desktop
pos_overall
An indication of the position of the Item Carousel result within the SERP.
integer
Desktop
items
A list of selected recipes with their respective details.
array
Desktop and Mobile
items.pos
The position of the recipe within the Recipes SERP feature.
integer
Desktop and Mobile
items.url
The URL to the full recipe.
string
Desktop and Mobile
items.desc
A short description of the recipe retrieved from the original article.
string
Desktop
items.title
The title of the recipe.
string
Desktop and Mobile
items.rating
The rating of the recipe.
integer
Desktop and Mobile
items.source
The name of the website where the recipe is located.
string
Desktop and Mobile
items.duration
The time that is needed to prepare the dish.
string
Desktop and Mobile
pos_overall
An indication of the position of the Recipes result within the SERP.
integer
Desktop and Mobile
items
A list containing all of the video section results.
array
Desktop and Mobile
items.pos
The position of the video inside the list.
integer
Desktop and Mobile
items.url
A link to the video.
string
Desktop and Mobile
items.title
The title of the video.
string
Desktop and Mobile
items.author
The name of the profile where the video had been uploaded.
string
Desktop and Mobile
items.source
The name of the platform hosting the video.
string
Desktop and Mobile
pos_overall
An indication of the position of the Videos result within the SERP.
integer
Desktop and Mobile
url
The URL of the website from which the snippet describing the page is retrieved.
string
Desktop and Mobile
desc
The snippet containing a description for a specific search result.
string
Desktop and Mobile
title
The name of the article from which the snippet describing a page is retrieved.
string
Desktop and Mobile
url_shown
The URL of the website containing the featured snippet that is visible in the SERP.
string
Desktop and Mobile
pos_overall
An indication of the position of the Featured Snippet result within the SERP.
integer
Desktop and Mobile
items
A list containing all of the related searches items retrieved from a horizontal carousel within the SERP.
array
Desktop
items.url
The URL of the related search page.
string
Desktop
items.title
The name of the related search result rendered in the browser.
string
Desktop
category
An object containing more details regarding the category of the related search results.
object
Desktop
category.name
The name of the category.
string
Desktop
category.type
The type of the related search section.
string
Desktop
pos_overall
An indication of the position of the Related Searches Categorized result within the SERP.
integer
Desktop
date_to
The date of the check-out.
string
Desktop
results
A list with all of the hotel's details.
array
Desktop
results.price
The price of the hotel.
string
Desktop
results.title
The name of the hotel.
string
Desktop
results.description
A short description of the hotel visible just below the name of the hotel.
string
Desktop
date_from
The date of the check-in.
string
Desktop
pos_overall
An indication of the position of the Hotels result within the SERP.
integer
Desktop
to
The airport of arrival.
string
Desktop and Mobile
from
The airport of departure.
string
Desktop and Mobile
date_to
The day of the arrival.
string
Desktop and Mobile
results
A list of selected flights with their respective details.
array
Desktop and Mobile
results.url
A link to Google Flights page listing all flights from a single airline.
string
Desktop and Mobile
results.type
The type of the flight.
string
Desktop
results.price
The price of the flight.
string
Desktop and Mobile
results.airline
The name of the carrier.
string
Desktop and Mobile
results.duration
The duration of the flight.
string
Desktop and Mobile
date_from
The date of the departure.
string
Desktop and Mobile
pos_overall
An indication of the position of the Flights result within the SERP.
integer
Desktop and Mobile
url
The URL of the video.
string
Desktop and Mobile
title
The title of the video.
string
Desktop and Mobile
pos_overall
An indication of the position of the Video Box result within the SERP.
integer
Desktop and Mobile
items
A list of service providers with their respective details.
array
Desktop
items.pos
The position of the service ad within the Local Services Ads SERP feature.
integer
Desktop
items.url
A link to the service in the Local Services search page.
string
Desktop
items.title
The title of the service provider.
string
Desktop
items.rating
The rating of the service provider.
integer
Desktop
items.reviews_count
The number of reviews for the service provider.
integer
Desktop
items.google_guaranteed
Google badge which is provided to businesses that pass a Google screening and verification process. Available values are either "true" or "false".
boolean
Desktop
pos_overall
An indication of the position of the Local Service Ads result within the SERP.
integer
Desktop
id
The id of the application within the available app store.
string
Mobile
url
The URL of the application store containing full information about the application in the SERP.
string
Mobile
title
The title of the application.
string
Mobile
rating
The rating of the application.
integer
Mobile
reviews_count
The total number of reviews available for the Apps SERP result in the application store.
integer
Mobile
items.reviews_count
The number of reviews for the service provider.
string
Mobile
low
The low price for the specified date.
integer
Desktop
date
The date at which the net asset value was reported.
string
Desktop
high
The high price for the specified date
integer
Desktop
open
The opening price for the specified date
integer
Desktop
source
The URL to the relevant Google Finance source website.
string
Desktop
difference
The change in the most recently reported net asset value and the one immediately prior.
string
Desktop
market_cap
The total dollar value of a company's outstanding shares of stock
string
Desktop
stock_name
The name of the stock.
string
Desktop
52_week_low
The 52-week low price
integer
Desktop
52_week_high
The 52-week high price
integer
Desktop
current_price
Real-time price quote.
string
Desktop
dividend_yield
The dividend–price ratio of a share is the dividend per share divided by the price per share
integer
Desktop
price_earning_ratio
The price to earning ratio of the stock
integer
Desktop
games
An array which provides information about a number of sports games
array
Desktop
games.date
The date and time when the game is scheduled to take place or when it occurred
string
Desktop
games.teams
The teams involved in the game
array
Desktop
games.game_type
The type of game being played, such as a regular season match, playoff game, championship game, etc.
string
Desktop
games.highlight
A link to notable highlights from the game, such as key plays, goals, etc.
string
Desktop
games.teams.score
The scores or points earned by each team during the game
string
Desktop
games.teams.winner
Specifies which team won the game
boolean
Desktop
games.teams.team_name
Displays the names of the teams involved in the game
string
Desktop
stage
The specific phase or stage of a sports competition or tournament.
string
Desktop
league
Refers to the sports league or organization overseeing the competition
string
Desktop
items
An array of items or entries within a forum or discussion thread that Google has indexed
array
Desktop
items.pos
An indicator denoting the position of a given item among all Discussions and Forums results.
integer
Desktop
items.url
The URL link to the specific forum post or discussion thread
string
Desktop
items.title
The title or headline of the forum post or discussion topic
string
Desktop
items.source
The source which hosts the forum or discussion
string
Desktop
items.timeframe
The timeframe or date of the forum post or discussion
string
Desktop
items.comments_count
The number of comments or replies the forum post or discussion thread has received
string
Desktop
pos_overall
An indication of the position of the Discussions and Forums SERP feature within the SERP.