Web Search

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 Search or News 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.

curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "domain": "nl",
        "query": "adidas",
        "start_page": 11,
        "pages": 2,
        "parse": true,
        "context": [
            {
                "key": "results_language",
                "value": "fr"
            }
        ]
    }'

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_search',
    'domain': 'nl',
    'query': 'adidas',
    'start_page': 11,
    'pages': 2,
    'parse': True,
    'context': [
        {'key': 'results_language', 'value': 'fr'},
    ],
}


# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_search",
    domain: "nl",
    query: "adidas",
    start_page: 11,
    pages: 2,
    parse: true,
    context: [
        { key: "results_language", value: "fr" },
    ],
};

const options = {
    hostname: "realtime.oxylabs.io",
    path: "/v1/queries",
    method: "POST",
    headers: {
        "Content-Type": "application/json",
        Authorization:
            "Basic " + Buffer.from(`${username}:${password}`).toString("base64"),
    },
};

const request = https.request(options, (response) => {
    let data = "";

    response.on("data", (chunk) => {
        data += chunk;
    });

    response.on("end", () => {
        const responseData = JSON.parse(data);
        console.log(JSON.stringify(responseData, null, 2));
    });
});

request.on("error", (error) => {
    console.error("Error:", error);
});

request.write(JSON.stringify(body));
request.end();

https://realtime.oxylabs.io/v1/queries?source=google_search&domain=nl&query=adidas&start_page=11&pages=2&parse=true&context[0][key]=results_language&context[0][value]=fr&access_token=12345abcde

<?php

$params = array(
    'source' => 'google_search',
    'domain' => 'nl',
    'query' => 'adidas',
    'start_page' => 11,
    'pages' => 2,
    'parse' => true,
    'context' => [
        [
            'key' => 'results_language',
            'value' => 'fr',
        ]
    ]
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "USERNAME" . ":" . "PASSWORD");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "USERNAME"
	const Password = "PASSWORD"

	payload := map[string]interface{}{
		"source":     "google_search",
		"domain":     "nl",
		"query":      "adidas",
		"start_page": 11,
		"pages":      2,
		"parse":      true,
		"context": []map[string]interface{}{
			{"key": "results_language", "value": "fr"},
		},
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "USERNAME";
            const string Password = "PASSWORD";

            var parameters = new {
                source = "google_search",
                domain = "nl",
                query = "adidas",
                start_page = 11,
                pages = 2,
                parse = true,
                context = new dynamic [] {
                    new { key = "results_language", value = "fr" },
                }
            };

            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

package org.example;

import okhttp3.*;
import org.json.JSONArray;
import org.json.JSONObject;
import java.util.concurrent.TimeUnit;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "USERNAME";
    public static final String PASSWORD = "PASSWORD";

    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "google_search");
        jsonObject.put("domain", "nl");
        jsonObject.put("query", "adidas");
        jsonObject.put("start_page", 11);
        jsonObject.put("pages", 2);
        jsonObject.put("parse", true);
        jsonObject.put("context", new JSONArray()
                .put(new JSONObject()
                        .put("key", "results_language")
                        .put("value", "fr"))
        );

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);
            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .readTimeout(180, TimeUnit.SECONDS)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            if (response.body() != null) {
                try (var responseBody = response.body()) {
                    System.out.println(responseBody.string());
                }
            }
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

{
    "source": "google_search",
    "domain": "nl",
    "query": "adidas",
    "start_page": 11,
    "pages": 2,
    "parse": true,
    "context": [
        {
            "key": "results_language",
            "value": "fr"
        }
    ]
}

We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.

Request parameter values

Generic

Basic setup and customization options for scraping Google Web search results.

Parameter

Description

Default Value

source

Sets the scraper.

google_search

query

UTF-encoded keyword.

render

Enables JavaScript rendering when set to html. More info.

parse

Returns parsed data when set to true. Explore output data dictionary.

false

callback_url

URL to your callback endpoint. More info.

user_agent_type

Device type and browser. The full list can be found here.

desktop

- 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.

{
    "source": "google_search",
    "query": "iphone 15 launch inurl:apple",
}

Localization

Adapt search results to specific geographical locations, domains, and languages.

Parameter

Description

Default Value

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.

Pagination

Controls for managing the pagination and retrieval of search results.

Parameter

Description

Default Value

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.

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:

Parameter

Description

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

Request sample

{
    "source": "google_search",
    "query": "adidas",
    "parse": true,
    "context": [
        {
            "key": "limit_per_page",
            "value": [
                {"page": 1, "limit": 10},
                {"page": 2, "limit": 90}
                    ]
        }]
}

Filtering

Options to filter and refine search results based on various criteria. Learn how to use context parameters here.

Parameter

Description

Default Value

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.

context: tbm

To-be-matched or tbm parameter. Accepted values are: app, blg, bks, dsc, isch, nws, pts, plcs, rcp, lcl

context: tbs

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.

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.

Parameter

Description

Default Value

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

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.

Key Name

Description

Type

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

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.

...
"pla": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.amazon.com/Switch-Controllers-Wildcat-Touchscreen-Bluetooth/dp/B09N4S9TWV?source=ps-sl-shoppingads-lpcontext&ref_=fplfs&psc=1&smid=A1GYW88KAZG2FO",
            "price": "$675.49",
            "title": "Switch PURTCH Newest w/Yellow & Blue controllers Wildcat Bundle(2000 V-Bucks and Code for Wildcat Bundle Included), 6.2\" Touchscreen LCD Display, 802.11",
            "seller": "Amazon.com",
            "url_image": "https://encrypted-tbn0.gstatic.com/shopping?q=tbn:ANd9GcSdvbTlG8SxMmPAm6cjeiFXvrNCIF0ZIBUUqz4B4Uww2fY7sHhaEQxbDv_JP78tu-YO3kWFbTESJPcAx5h2zezUK3bpZJnVriMGOi7Tx7nJNA8&usqp=CAc",
            "image_data": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
        },
        ...
    ],
    "pos_overall": 1
},
...

Key (results.pla)

Description

Type

Layout

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

Paid

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
    }
]
...

Key (results.paid)

Description

Type

Layout

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

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.

...
"images": {
    "items": [
        {
            "alt": "Adidas | History, Products, & Facts | Britannica",
            "pos": 1,
            "url": "https://www.britannica.com/topic/Adidas-AG"
        },
        {
            "alt": "Superstar x Indigo Herz Shoes",
            "pos": 2,
            "url": "https://www.adidas.com/us/superstar-x-indigo-herz-shoes/IE1842.html"
        },
        {
            "alt": "adidas (@adidas) / X",
            "pos": 3,
            "url": "https://twitter.com/adidas"
        }
    ],
    "pos_overall": 4
},
...

Key (results.images)

Description

Type

Layout

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

Organic

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.

Example 1

...
"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
    },
...

Example 2

...
"organic": [
    {
        "pos": 9,
        "pos_overall": 13,
        "title": "Classics Winter Track Jacket - Army Green",
        "url": "https://www.reebok.com/p/100030586/classics-winter-track-jacket",
        "url_shown": "https://www.reebok.com\u203a classics-winter-track-jacket",
        "desc": "A soft sherpa track jacket rooted in outdoor winter sports \u00b7 Relaxed fit is loose, casual and totally unrestrictive \u00b7 Shell: 70% polyester / 30% recycled\u00a0...",
        "favicon_text": "Reebok",
        "images": [
            "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcS7NvhUuvYcmAxmRNswAEkR6HZo-KYMwmNcynhHjwa2UE1l8cjy4isr&s"
        ],
        "rating": 3.9,
        "review_count": 7,
        "additional_info": [
            "$23.99$80",
            "In stock",
            "3.9(7)",
            "Free delivery over $75",
            "Free 30-day returns"
        ]
    },
...

Key (results.organic)

Description

Type

Layout

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

favicon_text

The text or name associated with the favicon (website icon).

string

Desktop

rating

The average rating of the product or content.

float

Desktop

review_count

The number of reviews associated with the product or content.

integer

Desktop

additional_info

Contains details about pricing, availability, product ratings, delivery options, return policies.

list of strings

Desktop

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
    },
...

Key (results.organic_videos)

Description

Type

Layout

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

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.

...
"top_sights": {
    "items": [
        {
            "pos": 1,
            "title": "Vilnius Cathedral"
        },
        {
            "pos": 2,
            "title": "Gediminas Castle Tower"
        },
        {
            "pos": 3,
            "title": "Gates of Dawn"
        }
    ],
    "pos_overall": 1
},
...

Key (results.top_sights)

Description

Type

Layout

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

Jobs

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.

...
"jobs": {
    "listings": [
        {
            "url": "https://www.google.com/search?q=divorce+lawyer+jobs&filter=1&safe=off&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en&ibp=htl;jobs&sa=X&ved=2ahUKEwjI1ZPX2sGEAxVrcGwGHcEpAjAQkd0GegQIIRAB#fpstate=tldetail&htivrt=jobs&htiq=divorce+lawyer+jobs&htidocid=PezDD3LkXHvbWvM-AAAAAA%3D%3D",
            "title": "Attorney",
            "source": "via LinkedIn",
            "employer": "Men's & Fathers' Rights Divorce Lawyers, Schultz & Associates, LLC",
            "location": "United States"
        },
                            ...
    ],
    "pos_overall": 1
},
...

Key (results.jobs)

Description

Type

Layout

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

Twitter (X)

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
},
...

Key (results.twitter)

Description

Type

Layout

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

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"
        },
        ...
    ]
},
...

Key (results.knowledge)

Description

Type

Layout

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

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.

...
"local_pack": {
                        "items": [
                            {
                                "cid": "1100080596967423812",
                                "pos": 1,	
                                "title": "Pizza Hut",
                                "rating": 3.8,
                                "address": "Independence, KS",
                                "subtitle": "Pizza",
                                "rating_count": 435
                            },
                            ...
                        ],
                        "pos_overall": 1
                    },
...

Key (results.local_pack)

Description

Type

Layout

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

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.

...
"popular_products":[
   {
      "items":[
         {
            "pos":1,
            "price":"$109.99",
            "title":"adidas Gazelle Herren",
            "seller":"Footlocker.de",
            "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..."
         },
         {
            "pos":2,
            "price":"$120.00",
            "title":"Herren adidas Gazelle Schuh",
            "rating":"4.9",
            "seller":"JD Sports Deutschland",
            "image_data":"/9j/4AAQSkZJRgABAQAAAQABAAD/..."
         },
         ...
      ],
      "pos_overall":4
   },
   ...
]
...

Key (results.popular_products)

Description

Type

Layout

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

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"
    ]
},
...

Key (results.related_searches)

Description

Type

Layout

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

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
},
...

Key (results.related_questions)

Description

Type

Layout

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

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
},
...

Key (results.search_information)

Description

Type

Layout

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

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.

...
"item_carousel": {
    "items": [
        {
            "pos": 1,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "Burj Khalifa 828\u00a0m, 830\u00a0m to tip",
            "subtitle": "828m, 830m to tip"
        },
        {
            "pos": 2,
            "href": "/search?safe=off&sca_esv=589070032...",
            "title": "Warisan Merdeka Tower 679\u00a0m",
            "subtitle": "679m"
        },
...
     ],
    "title": "Buildings (by Height)",
    "pos_overall": 1
},
...

Key (results.item_carousel)

Description

Type

Layout

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

Recipes

The recipes SERP feature on Google presents cooking instructions, ingredients, ratings, and sources for specific dishes at the top of search results.

...
"recipes": {
    "items": [
        {
            "pos": 1,
            "url": "https://handletheheat.com/chewy-brownies/",
            "desc": "Unsweetened cocoa powder, chocolate chips, baking soda, egg yolk, all purpose flour",
            "title": "Best Ever Chewy Brownies",
            "rating": 4.8,
            "source": "Handle the Heat",
            "duration": "45 mins"
        },
...
    ],
    "pos_overall": 1
},
...

Key (results.recipes)

Description

Type

Layout

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

Videos

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
},
...

Key (results.videos)

Description

Type

Layout

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

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
    }
],
...

Key (results.featured_snippet)

Description

Type

Layout

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

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
    },
...

Key (results.related_searches_categorized)

Description

Type

Layout

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

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
},
...

Key (results.hotels)

Description

Type

Layout

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

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
},
...

Key (results.flights)

Description

Type

Layout

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

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
},
...

Key (results.video_box)

Description

Type

Layout

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

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.

...
"local_service_ads": {
    "items": [
        {
            "pos": 1,
            "url": "/localservices/prolist?g2lbs=...=accident+lawyer",
            "title": "Crandall & Katt, Attorneys at Law",
            "rating": 4.4,
            "reviews_count": 254,
            "google_guaranteed": true
        },
       ...
    ],
    "pos_overall": 2
},
...

Key (results.local_service_ads)

Description

Type

Layout

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

Apps

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.

...
"apps": [
    {
        "id": "com.instagram.android",
        "url": "https://play.google.com/store/apps/details?id=com.instagram.android&hl=en_US&gl=US&referrer=utm_source%3Dgoogle%26utm_medium%3Dorganic%26utm_term%3Dinstagram&pcampaignid=APPU_1_WsivZdzUFMbZ1sQPrf-yoAU",
        "title": "Instagram",
        "rating": "4.4",
        "reviews_count": "151M"
    }
],
...

Key (results.apps)

Description

Type

Layout

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

Finance

A summary of financial data for companies, including stock prices, market cap, and other key metrics.

HTML example

Key (results.finance)

Description

Type

Layout

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

JSON sample

...                   
"finance": {
    "low": 157.51,
    "date": "Apr 25, 8:09AM EDT",
    "high": 167.97,
    "open": 162.84,
    "source": "https://www.google.com/finance/quote/TSLA:NASDAQ?sa=X&ved=2ahUKEwjl29u-qt2FAxWFLbkGHUyiCt0Q3ecFegQIfhAX",
    "difference": "+17.45 (12.06%)",
    "market_cap": "508.03B",
    "stock_name": "NASDAQ: TSLA",
    "52_week_low": 138.8,
    "52_week_high": 299.29,
    "current_price": "162.13 USD",
    "dividend_yield": 0,
    "price_earnings_ratio": 41.47
},
...

Sports games

Information on recent sports games, detailing scores, teams, game types, and highlights.

HTML example

Key (results.sports_games)

Description

Type

Layout

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

JSON sample

...                 
"sports_games": {
    "games": [
  		...
                {
            "date": "Yesterday",
            "teams": [
                {
                    "score": "75",
                    "winner": false,
                    "team_name": "Barcelona"
                },
                {
                    "score": "77",
                    "winner": true,
                    "team_name": "Olympiacos"
                }
            ],
            "game_type": "Final",
            "highlight": "https://stories.euroleague.net/games/329003-20240424-Barcelona-vs-Olympiacos-Piraeus.html"
        },
    				...
    ],
    "stage": "Quarter-final",
    "league": "EuroLeague"
},
...

Discussions and forums

A list of discussion threads and forum posts with URLs, titles, sources, and comment counts.

HTML sample

Key (results.discussions_and_forums)

Description

Type

Layout

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.

integer

Desktop

JSON sample

...
"discussions_and_forums": {
    "items": [
        {
            "pos": 1,
            "url": "https://www.reddit.com/r/webscraping/comments/y4v5ws/free_http_proxy/",
            "title": "Free HTTP Proxy? : r/webscraping - Reddit",
            "source": "Reddit",
            "timeframe": "1y",
            "comments_count": "20+ comments"
        },
        ...
    ],
    "pos_overall": 7
}
},
...

PreviousGoogle NextAI Overviews

Last updated 2 months ago

Was this helpful?

Request samples

Request parameter values

Generic

Google Advanced Search Operators

Localization

Pagination

Continuous scroll support

Limit per page

Request sample

Filtering

Other

Context parameters

Structured data

Output data dictionary

JSON structure

Product Listing Ads (PLA)

Paid

Images

Organic

Example 1

Example 2

Organic Videos

Top Sights

Jobs

Twitter (X)

Knowledge

Local Pack

Top Stories

Popular Products

Related Searches

Related Questions

Search Information

Item Carousel

Recipes

Videos

Featured Snippet

Related Searches Categorized

Hotels

Flights

Video Box

Local Service Ads

Apps

Finance

HTML example

JSON sample

Sports games

HTML example

JSON sample

Discussions and forums

HTML sample

JSON sample