# Web Search

The `google_search` source is designed to retrieve Google Search (SERPs) and Google AI Overviews results. This sub-page specifically presents information related to Google Web Search. To explore other result types, read [**Image Search**](/api-targets/search-engines/google/search/image-search.md) or[ **News Search**](/api-targets/search-engines/google/search/news-search.md).

## 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`. API will return parsed results.

{% tabs %}
{% tab title="cURL" %}

```shell
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
        "source": "google_search",
        "query": "adidas",
        "start_page": 11,
        "pages": 2,
        "parse": true,
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'google_search',
    'query': 'adidas',
    'start_page': 11,
    'pages': 2,
    'parse': True,
}


# 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())
```

{% endtab %}

{% tab title="Node.js" %}

```javascript
const https = require("https");

const username = "USERNAME";
const password = "PASSWORD";
const body = {
    source: "google_search",
    query: "adidas",
    start_page: 11,
    pages: 2,
    parse: true,
};

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();
```

{% endtab %}

{% tab title="HTTP" %}

```http
https://realtime.oxylabs.io/v1/queries?source=google_search&query=adidas&start_page=11&pages=2&parse=true&&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'google_search',
    'query' => 'adidas',
    'start_page' => 11,
    'pages' => 2,
    'parse' => true,
);

$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);
```

{% endtab %}

{% tab title="Golang" %}

```go
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",
		"query":      "adidas",
		"start_page": 11,
		"pages":      2,
		"parse":      true,
	}

	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))
}
```

{% endtab %}

{% tab title="C#" %}

```csharp
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",
                query = "adidas",
                start_page = 11,
                pages = 2,
                parse = true,
            };

            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);
        }
    }
}
```

{% endtab %}

{% tab title="Java" %}

```java
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("query", "adidas");
        jsonObject.put("start_page", 11);
        jsonObject.put("pages", 2);
        jsonObject.put("parse", true);

        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();
    }
}
```

{% endtab %}

{% tab title="JSON" %}

```json
{
    "source": "google_search",
    "query": "adidas",
    "start_page": 11,
    "pages": 2,
    "parse": true,
}
```

{% endtab %}
{% endtabs %}

We use synchronous [**Realtime**](/products/web-scraper-api/integration-methods/realtime.md) integration method in our examples. If you would like to use [**Proxy Endpoint**](/products/web-scraper-api/integration-methods/proxy-endpoint.md) or asynchronous [**Push-Pull**](/products/web-scraper-api/integration-methods/push-pull.md) integration, refer to the [**integration methods**](/products/web-scraper-api/integration-methods.md) section.

## Request parameter values

### Generic

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

<table><thead><tr><th width="222">Parameter</th><th width="350.3333333333333">Description</th><th>Default Value</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong>source</strong></mark></td><td>Sets the scraper.</td><td><code>google_search</code></td></tr><tr><td><mark style="background-color:green;"><strong>query</strong></mark></td><td>The keyword or phrase to search for.</td><td>-</td></tr><tr><td><code>render</code></td><td>Enables JavaScript rendering when set to <code>html</code>. <a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/pGs7q0aw7gpLmDsoGTdt#javascript-rendering"><strong>More info</strong></a><strong>.</strong></td><td>-</td></tr><tr><td><code>parse</code></td><td>Returns parsed data when set to <code>true</code>. Explore output <a href="#output-data-dictionary"><strong>data dictionary</strong></a>.</td><td><code>false</code></td></tr><tr><td><code>callback_url</code></td><td>URL to your callback endpoint. <a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/DijMC0XcEbNczNgRaHIV"><strong>More info</strong></a></td><td>-</td></tr><tr><td><code>user_agent_type</code></td><td>Device type and browser. The full list can be found <a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/rrKXR4LNzotP94phU1YL"><strong>here</strong></a>.</td><td><code>desktop</code></td></tr></tbody></table>

&#x20;    \- 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**](https://ahrefs.com/blog/google-advanced-search-operators/) and [**here**](https://www.semrush.com/kb/831-how-to-use-google-advanced-search-operators). See an example below.

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

### Localization

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

<table><thead><tr><th width="222">Parameter</th><th width="350.3333333333333">Description</th><th>Default Value</th></tr></thead><tbody><tr><td><code>geo_location</code></td><td>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 <code>geo_location</code> parameter structures <a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/MzPAMWq8tFiQFjuZRyEM#google"><strong>here</strong></a><strong>.</strong></td><td>-</td></tr><tr><td><code>locale</code></td><td><code>Accept-Language</code> header value which changes your Google search page web interface language. <a href="/spaces/BQ7Zf9paoN3FTeGcyfY1/pages/rAkVD7OwCRtmZreOVBiG#google"><strong>More info</strong></a>.</td><td>-</td></tr></tbody></table>

### Pagination

Controls for managing the pagination and retrieval of search results.

<table><thead><tr><th width="222">Parameter</th><th width="350.3333333333333">Description</th><th width="167">Default Value</th></tr></thead><tbody><tr><td><code>start_page</code></td><td>Starting page number.</td><td><code>1</code></td></tr><tr><td><code>pages</code></td><td>Number of pages to retrieve.</td><td><code>1</code></td></tr><tr><td><code>limit</code></td><td>Number of results to retrieve in each page.</td><td><code>10</code></td></tr><tr><td><code>context</code>:<code>limit_per_page</code></td><td>Scrape multiple pages using the same IP address and session (cookie set). By specifying the page numbers in a JSON array with the <code>page</code> key and indicating the number of organic results per page using the <code>limit</code> 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). <a href="#request-sample"><strong>See example</strong></a><strong>.</strong></td><td>-</td></tr></tbody></table>

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

{% hint style="warning" %}
Due to recent Google limit changes, we've adjusted Web Scraper API's behavior. Maximum results per page will match Google's organic output, which is typically 10 results.
{% endhint %}

To use this feature, include a JSON array with JSON objects containing the following data:

<table><thead><tr><th width="142">Parameter</th><th width="446.3333333333333">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>page</code></td><td>The number of the page you would like to scrape. Any integer value greater than <code>0</code> will work</td><td><code>1</code></td></tr><tr><td><code>limit</code></td><td>The number of results on the page in question. Any integer value between <code>1</code> and <code>100</code> (inclusive) will work.</td><td><code>90</code></td></tr></tbody></table>

#### Request sample

```json
{
    "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**](#context-parameters).

<table><thead><tr><th width="245">Parameter</th><th width="350.3333333333333">Description</th><th>Default Value</th></tr></thead><tbody><tr><td><code>context</code>:<br><code>filter</code></td><td>Setting the value of this parameter to <code>0</code> lets you see results that would otherwise be excluded due to similarity to other results.</td><td><code>1</code></td></tr><tr><td><code>context</code>:<br><code>safe_search</code></td><td>Safe search. Set to <code>true</code> to enable it.</td><td><code>false</code></td></tr><tr><td><code>context</code>:<br><code>udm</code></td><td><code>udm</code> parameter allows switching between different search tabs, such as images, places, or videos, to customize the type of results displayed. Find the accepted values <a href="https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FeoShpvYuZlb4hGpCIXNG%2Fudm_values%20(eu%2Bus).json?alt=media&#x26;token=a6b77fab-b170-478c-b06f-b8fbf7ab64c7"><strong>here</strong></a>.</td><td>-</td></tr><tr><td><code>context</code>:<br><code>tbm</code></td><td>To-be-matched or <code>tbm</code> parameter. Accepted values are: <code>app</code>, <code>blg</code>, <code>bks</code>, <code>dsc</code>, <code>isch</code>, <code>nws</code>, <code>pts</code>, <code>plcs</code>, <code>rcp</code>, <code>lcl</code></td><td>-</td></tr><tr><td><code>context</code>:<br><code>tbs</code></td><td>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 <code>tbm</code> parameter (e.g. <code>tbs=app_os:1</code> is only available with <code>tbm</code> value <code>app</code>). More info <a href="https://stenevang.wordpress.com/2013/02/22/google-advanced-power-search-url-request-parameters/"><strong>here</strong></a>.</td><td>-</td></tr></tbody></table>

{% hint style="warning" %}
`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.
{% endhint %}

### Other

Additional advanced settings and controls for specialized requirements.

<table><thead><tr><th width="222">Parameter</th><th width="350.3333333333333">Description</th><th>Default Value</th></tr></thead><tbody><tr><td><code>context</code>:<br><code>fpstate</code></td><td>Setting the <code>fpstate</code> value to <code>aig</code> will make Google load more apps. This parameter is only useful if used together with the <code>render</code> parameter.</td><td>-</td></tr><tr><td><code>context</code>:<br><code>nfpr</code></td><td><code>true</code> will turn off spelling auto-correction</td><td><code>false</code></td></tr></tbody></table>

### Context parameters

All context parameters should be added to the `context` array as objects with `key` and `value` pairs, e.g.:

```json
...
"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.

<details>

<summary><code>google_search</code> structured output</summary>

```json
{
    "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": "iVBORw0KGgoAAAANSUhEU...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"
        }
    ]
}
```

</details>

{% hint style="info" %}
The composition of elements may differ based on whether it was a **desktop** or **mobile** search.
{% endhint %}

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

<figure><img src="https://lh7-us.googleusercontent.com/3R1boJs4sRlfCxUF-hCW5LkvivMlEKWS1kCzAjAF8GnFEd7z0m9ME8pI-ZUQxhkIj6cNVb6LvCDWNGAJB8hlKEjNlR3J84_0e6sFzCA15eNgf9EX_aZ_cK9cnir1fFSNBnPSgDziKw_tmDxyrMGU5Wc" alt=""><figcaption></figcaption></figure>

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

{% hint style="info" %}
The number of items and fields for a specific result type may vary depending on the search query.
{% endhint %}

<table data-full-width="false"><thead><tr><th width="289">Key Name</th><th width="337.3333333333333">Description</th><th>Type</th></tr></thead><tbody><tr><td><code>url</code></td><td>The URL of the Google search page.</td><td>string</td></tr><tr><td><code>page</code></td><td>Page number relative to the Google SERP pagination.</td><td>integer</td></tr><tr><td><code>results</code></td><td>A dictionary containing the results of the search.</td><td>object</td></tr><tr><td><code>results.pla</code></td><td>A list of product listing ads with their respective details.</td><td>object</td></tr><tr><td><code>results.paid</code></td><td>A list of sponsored results with their respective details.</td><td>array</td></tr><tr><td><code>results.images</code></td><td>A list of image results with their respective details.</td><td>object</td></tr><tr><td><code>results.flights</code></td><td>A list of flights with their respective details.</td><td>object</td></tr><tr><td><code>results.organic</code></td><td>A list of unpaid listings with their respective details.</td><td>array</td></tr><tr><td><code>results.organic_videos</code></td><td>A list of organic videos with their respective details.</td><td>array</td></tr><tr><td><code>results.top_sights</code></td><td>A list of notable landmarks or attractions with their respective details.</td><td>array</td></tr><tr><td><code>results.jobs</code></td><td>A list of jobs listings with their respective details.</td><td>object</td></tr><tr><td><code>results.local_service_ads</code></td><td>A list of sponsored local service providers.</td><td>object</td></tr><tr><td><code>results.video_boxes</code></td><td>Video boxes in the SERP with their respective details.</td><td>array</td></tr><tr><td><code>results.recipes</code></td><td>A list of recipes with their respective details.</td><td>object</td></tr><tr><td><code>results.twitter</code></td><td>A list of Twitter (X) results with their respective details.</td><td>array</td></tr><tr><td><code>results.knowledge</code></td><td>A list of relevant information retrieved from the knowledge panel.</td><td>object</td></tr><tr><td><code>results.local_pack</code></td><td>A list containing local business listings relevant to the search.</td><td>object</td></tr><tr><td><code>results.item_carousel</code></td><td>A list of illustrative items for informational queries with their respective details.</td><td>object</td></tr><tr><td><code>results.videos</code></td><td>A list of videos with their respective details.</td><td>object</td></tr><tr><td><code>results.hotels</code></td><td>A list of hotels relevant to the location used in the search query.</td><td>object</td></tr><tr><td><code>results.apps</code></td><td>A list of applications with their respective details.</td><td>array</td></tr><tr><td><code>results.finance</code></td><td>A summary of financial data for companies, including stock prices, market cap, and other key metrics.</td><td>object</td></tr><tr><td><code>results.sports_games</code></td><td>Information on recent sports games, detailing scores, teams, game types, and highlights.</td><td>object</td></tr><tr><td><code>results.discussions_and_forums</code></td><td>A list of discussion threads and forum posts with URLs, titles, sources, and comment counts.</td><td>object</td></tr><tr><td><code>results.featured_snippet</code></td><td>A list of specific results retrieved from the organic part of SERPs.</td><td>array</td></tr><tr><td><code>results.top_stories</code></td><td>A list of articles with their respective details when a search query is identified as news-oriented.</td><td>object</td></tr><tr><td><code>results.popular_products</code></td><td>A list of unpaid and organic displays of Google Shopping product listings with their respective details.</td><td>object</td></tr><tr><td><code>results.related_searches</code></td><td>A list of one or more related searches blocks presented at different positions on the search page.</td><td>array</td></tr><tr><td><code>results.related_questions</code></td><td>A list of related interrogative search queries with their respective details.</td><td>object</td></tr><tr><td><code>results.what_people_are_saying</code></td><td>A list of discussion threads and forum posts with URLs, titles, sources, top comments, engagement level and timeframes.</td><td>array</td></tr><tr><td><code>results.search_information</code></td><td>A list of details for the submitted search query.</td><td>object</td></tr><tr><td><code>total_results_count</code></td><td>The total number of results found for the search query.</td><td>string</td></tr><tr><td><code>last_visible_page</code></td><td>Value identifying the maximum page number visible in the search query results page. (-1 when loading of more results is initiated by scrolling).</td><td>integer</td></tr><tr><td><code>parse_status_code</code></td><td>The status code of the parsing job. You can see the parser status codes described <a href="https://developers.oxylabs.io/scraper-apis/web-scraper-api/response-codes#parsers"><strong>here</strong></a>.</td><td>integer</td></tr><tr><td><code>created_at</code></td><td>The timestamp when the scraping job was created.</td><td>timestamp</td></tr><tr><td><code>updated_at</code></td><td>The timestamp when the scraping job was finished.</td><td>timestamp</td></tr><tr><td><code>job_id</code></td><td>The ID of the job associated with the scraping job.</td><td>string</td></tr><tr><td><code>status_code</code></td><td>The status code of the scraping job. You can see the scraper status codes described <a href="/pages/PpAgJ3odBUGijPxHsnTV"><strong>here</strong></a>.</td><td>integer</td></tr><tr><td><code>parser_type</code></td><td>The type of the parser used for breaking down the HTML content.</td><td>string</td></tr></tbody></table>

{% hint style="info" %}
In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.
{% endhint %}

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

<figure><img src="https://lh7-us.googleusercontent.com/NbkZMAjFT16XTvDpnm0BcTGd992td20fwIHOfY4zcl9uqGe9LLnCWukha1eZ67zYZAFF0OfTh36rtHjhB4zF022EuF7Ya_Ud3xYqDDQEynL6zeHe6H9BYiWvq0ismzAZdWtEyKDNxWGOH_5WB_t-Ljs" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="217">Key (results.pla)</th><th width="298">Description</th><th width="95">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>All PLAs available within the page.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>An indicator denoting the position of a given item among PLA results.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url</code></td><td>The URL of the product.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.price</code></td><td>The price of the product in the listing ad.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.title</code></td><td>The title of the product in the listing ad.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.seller</code></td><td>The seller of the product in the listing ad.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url_image</code></td><td>The URL of the product image.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.image_data</code></td><td>The base64-encoded thumbnail image of the product.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the PLA SERP feature within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

### Paid

The `paid` section refers to advertisements powered by Google Ads, usually appearing above organic (non-paid) results.

<figure><img src="/files/uVobuHzgKjNmsCXkINjJ" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="216">Key (results.paid)</th><th width="281">Description</th><th width="118">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>pos</code></td><td>An indicator denoting the position of a given item among paid results.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>url</code></td><td>The URL of the paid result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>desc</code></td><td>A short description of the paid result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>title</code></td><td>The title of the paid result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>data_rw</code></td><td>Redirect URL of the paid result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks</code></td><td>An object containing information about internal links to a website that appears under the first search result on Google.</td><td>object</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.inline/expanded</code></td><td>A list of URLs with their respective details. The name of the key (`inline`/`expanded`) specifies the type of the <code>sitelinks</code> element.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.inline.url</code></td><td>The URL of the linked site.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.inline.title</code></td><td>The title of the linked site.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.inline.description</code></td><td>A short description of the linked site.</td><td>string</td><td>Desktop</td></tr><tr><td><code>url_shown</code></td><td>The short-hand URL visible just below the description.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the paid result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/30Yq-Z8cmckFz0daXsOts4a6YfUsgtHDGwbZ_HA6zDqhMAmubS_lgzUERt8eHkRq8bheH1clYw2Ye8WuGS3q05xJ6CrplufydlqEz45p97YaXwHWgjZJA-ttQxwSwNAOMdggvo2PZ9EYsNWm6EdrBEw" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="205">Key (results.images)</th><th width="295">Description</th><th width="112">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of images with their respective details.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.alt</code></td><td>The alt text of the image.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>A unique indicator denoting the image position in the list.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url</code></td><td>The URL of the web page containing the image.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Images SERP feature within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="/files/vYdWB4zFngwJMTeU59yX" alt=""><figcaption></figcaption></figure>

```json
...
"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

<figure><img src="/files/gM8q98zu9ZTl90Xe12mS" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="229">Key (results.organic)</th><th width="309">Description</th><th width="85">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>pos</code></td><td>An indicator denoting the position of a given item among organic results.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>url</code></td><td>The URL of the organic result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>desc</code></td><td>A short description of the organic result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>title</code></td><td>The title of the organic result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>images</code></td><td>The base64-encoded thumbnail images of the organic result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks</code></td><td>Object contains `expanded` or `inline` element with more details on the sitelinks.</td><td>object</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.expanded/inline</code></td><td>A list of sitelinks of the organic result. The name of the key (<code>inline</code>/<code>expanded</code>) specifies the type of the sitelinks element.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.expanded.url</code></td><td>The URL of the linked site.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>sitelinks.expanded.title</code></td><td>The title of the linked site.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>url_shown</code></td><td>The short-hand URL visible just below the description.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Organic result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>favicon_text</code></td><td>The text or name associated with the favicon (website icon).</td><td>string</td><td>Desktop</td></tr><tr><td><code>rating</code></td><td>The average rating of the product or content.</td><td>float</td><td>Desktop</td></tr><tr><td><code>review_count</code></td><td>The number of reviews associated with the product or content.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>additional_info</code></td><td>Contains details about pricing, availability, product ratings, delivery options, return policies.</td><td>list of strings</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="/files/2LnukoNxAnEYKbDkt49B" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="259">Key (results.organic_videos)</th><th width="294">Description</th><th width="100">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>pos</code></td><td>An indicator denoting the position of a given item among Organic Videos results.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>url</code></td><td>The URL of the video.</td><td>string</td><td>Desktop</td></tr><tr><td><code>desc</code></td><td>Short description of the video.</td><td>string</td><td>Desktop</td></tr><tr><td><code>title</code></td><td>The title of the video.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Organic Video result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/XjD5XFwXvm3TOvuc697ZR7RCSMje--l9RVjFnFKqBhT0ZvASTZCfnaB8RoDDAmLDcZzotKxMeUh4UglWZgnre3Q6ocP7P2cIGq0gtYJigCI2L5ymuVvgp47fpMqP3gxzottT-7ehxraqhRN9gX_ch7o" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="227">Key (results.top_sights)</th><th width="339">Description</th><th width="90">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of top attractions with their respective details.</td><td>array</td><td>Desktop</td></tr><tr><td><code>items.pos</code></td><td>The position of the Top Sights result within the Top Sights SERP feature.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>items.title</code></td><td>The title of the tourist attraction site.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Top Sights result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="/files/WWTktoFTXRmOxs9Km4rF" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="222">Key (results.jobs)</th><th width="318">Description</th><th width="94">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>listings</code></td><td>An array of all jobs listings available within the page.</td><td>array</td><td>Desktop</td></tr><tr><td><code>listings.url</code></td><td>The URL to the full job listing.</td><td>string</td><td>Desktop</td></tr><tr><td><code>listings.title</code></td><td>The title of the job position.</td><td>string</td><td>Desktop</td></tr><tr><td><code>listings.source</code></td><td>The source which contains the original job posting.</td><td>string</td><td>Desktop</td></tr><tr><td><code>listings.employer</code></td><td>The organization hiring for the identified position.</td><td>string</td><td>Desktop</td></tr><tr><td><code>listings.location</code></td><td>The location for the position.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Jobs SERP feature within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="/files/1WHlL6Xj7hTyHgkWX82r" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="201">Key (results.twitter)</th><th width="329">Description</th><th width="108">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>pos</code></td><td>An indicator denoting the position of a given item among organic results.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>url</code></td><td>The URL of the profile containing the Twitter (X) posts.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items</code></td><td>A list of Twitter (X) posts with their respective details.</td><td>array</td><td>Desktop</td></tr><tr><td><code>items.pos</code></td><td>An indicator denoting the position of a given tweet within the Twitter (X) SERP feature.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.url</code></td><td>The URL of the Twitter (X) post.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.content</code></td><td>A short description denoting all of the text from the relevant Twitter (X) post.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.timeframe</code></td><td>Describes how long ago the tweet was created.</td><td>string</td><td>Desktop</td></tr><tr><td><code>title</code></td><td>The title of the Twitter (X) profile.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Twitter result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="/files/iDI1Pp5OJs3IORbuTxiH" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="270">Key (results.knowledge)</th><th width="272">Description</th><th width="90">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>title</code></td><td>The title of the knowledge panel.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>images</code></td><td>A list of images used right next to the title.</td><td>array</td><td>Desktop</td></tr><tr><td><code>factoids</code></td><td>A list of all the facts used in the knowledge panel.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>factoids.links</code></td><td>A list of all the links related to a given factoid item.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>factoids.links.href</code></td><td>A hyperlink to the Google Search results page for the given factoid.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>factoids.links.title</code></td><td>The description of any linked pages related to the factoid.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>factoids.title</code></td><td>The name of the factoid section.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>factoids.content</code></td><td>The description of the factoid.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>profiles</code></td><td>A list of social media profiles listed in the knowledge panel.</td><td>string</td><td>Desktop</td></tr><tr><td><code>profiles.url</code></td><td>A link to the social media profile.</td><td>string</td><td>Desktop</td></tr><tr><td><code>profiles.title</code></td><td>The title of the social media profile.</td><td>string</td><td>Desktop</td></tr><tr><td><code>subtitle</code></td><td>A short explanation about the entity described in the title.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>description</code></td><td>A description denoting main information about the entity in the knowledge panel.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>related_searches</code></td><td>A list of related searches with their respective details.</td><td>array</td><td>Desktop</td></tr><tr><td><code>related_searches.url</code></td><td>The URL of the related search page.</td><td>string</td><td>Desktop</td></tr><tr><td><code>related_searches.title</code></td><td>The title of the related search page.</td><td>string</td><td>Desktop</td></tr><tr><td><code>related_searches.section_title</code></td><td>The name of the related search section.</td><td>string</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/J8nVUQzYARU51Hik66lXTk838wwpT8NSCOET09XuSsmbsMkiU58ziGkhWcV0SNqgJGeuHmMMU9ja8UrcPG9HAA-EKtu_bUMq90cVyP-luaJWiJdS_2izil7XLYorkJYcD-U4A3eocIxAn71vGq0eGY8" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="230">Key (results.local_pack)</th><th width="277">Description</th><th>Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of locations with their respective details.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.cid</code></td><td>A unique identification number assigned to a specific business listing.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>The position of the local result within the local pack.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.title</code></td><td>The title of the local entity.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.rating</code></td><td>The rating of the local entity.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.address</code></td><td>The address of the local entity.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.rating_count</code></td><td>The number of ratings for the local entity.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Local Pack result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

### Top Stories

`top_stories` is a dedicated section surfacing in Google Search for news-oriented queries.

<figure><img src="/files/1HIQG5xeWNWN3Oj7HCNl" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="233">Key (results.top_stories)</th><th width="295">Description</th><th width="100">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of selected news articles with their respective details.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>The position of the article within the Top Stories SERP feature.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url</code></td><td>The URL to the full article.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.title</code></td><td>The title of the article.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.section</code></td><td>The name of the Top Stories section.</td><td>string</td><td>Mobile</td></tr><tr><td><code>items.source</code></td><td>The name of the site where the article is published.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.timeframe</code></td><td>Describes how long ago the article was published.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>Indicates the overall position of the Top Stories SERP feature within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/DEOa71XwMl0sdxQsp_A95Jun--DTl4wsxQ01IFS7cR__-zmOsCCUBnEnZc1jCXVin1R4MtD3qGbYJYb5hTJrWiRzCm4gYG2Oc7b6E5nYgGDwxUzk4zp92jxW0_o1SA4eQikmD2p1AQLeZMVNlXCxFhc" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="277">Key (results.popular_products)</th><th width="257">Description</th><th width="97">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of popular products with their respective details.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>A unique indicator denoting the position of a given popular product within the Popular Products SERP feature.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.price</code></td><td>The price of a given popular product.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.title</code></td><td>The title of a given popular product.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.rating</code></td><td>The rating of a given popular product.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.seller</code></td><td>The seller of a given popular product.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.image_data</code></td><td>The base64-encoded thumbnail image of the product.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>Indicates the overall position of the Popular Products SERP feature within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

### Related Searches

The `related_searches` SERP feature displays alternative search queries related to the initial search keyword, typically located at the bottom of the SERP.

<figure><img src="https://lh7-us.googleusercontent.com/mPOehSe_0VrQn9PhohC3ydDSzoUna26yd81Dr2RVU_3JASnNOJLIsix2gi-8qXmU0VoRaxCNZ7HGaLDDf2mt_Y17Un6-fDJVyra_if4rc5Zut5E9Ozz7z4Hn_Y7IG0MgGbT17CrEAI7Nm50RAcRizuA" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="274">Key (results.related_searches)</th><th width="252">Description</th><th width="93">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>pos_overall</code></td><td>Indicates the overall position of this related searches block within the search page.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>related_searches</code></td><td>A list of related search strings within this block.</td><td>array</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="/files/dEwELHyMj4pjYzZvGPqt" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="279">Key (results.related_questions)</th><th width="256">Description</th><th width="91">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list containing all of the related questions.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>A unique indicator denoting the position of any given related question within the Related Questions SERP feature.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.answer</code></td><td>The answer to the related question.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.source</code></td><td>Contains values describing the source of the answer to the question.</td><td>object</td><td>Desktop and Mobile</td></tr><tr><td><code>items.source.url</code></td><td>The URL of the site which is used to obtain the answer.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.source.title</code></td><td>The title of the site which contains the answer.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.source.url_shown</code></td><td>The short-hand URL visible just below the answer.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.question</code></td><td>The question from the related questions section.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>Indicates the overall position of the Related Questions SERP feature within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

### What people are saying

The `what_people_are_saying` section appears in Google search results when there are relevant posts from forums, social media, or community platforms related to the search query. This section typically shows content from platforms like Reddit, TikTok and other discussion forums.

<figure><img src="/files/8EfJsWJzaEqHpAP9WgI5" alt=""><figcaption></figcaption></figure>

```json
...
"what_people_are_saying": {
                        "items": [
                            {
                                "pos": 1,
                                "url": "https://www.reddit.com/r/travel/comments/1kxf875/san_francisco_hotels/",
                                "title": "San Francisco hotels",
                                "top_comments": "Welcome to SF! A couple of notes.\n* October is normally our best weather all year. Great plan! (Anyone else reading this: \"summer\" in SF is typically very, very foggy and cold.)\n* (This is probably super obvious, so apologies in advance. Maybe it'll be helpful for someone else reading this.) The Niners don't actually play anywhere near SF. With no traffic, the drive from downtown SF to Levi's is about an hour. On public transit (maybe with Uber/Lyft assisting) it's 90-120 minutes.\n* I'd recommend staying in the city of SF itself. If you don't want to be in SF, then somewhere close to BART will allow you to sightsee without spending much money.\n* Within SF, be aware that the Tenderloin is a very rough neighborhood. That's the place you always see on Fox News with \"out of control San Francisco\" stories. The rest of the city is safe and fairly clean.\n* The west side of SF, and especially the Sunset, is less connected to public transit. You can definitely get around without a car, but it'll take you a bit longer to get downtown or to train systems.\nCongrats on the retirement! Sounds like a nice reward.",
                                "source": "Reddit",
                                "engagement_timeframe": "10+ comments, 1 week ago"
                            },
                            {
                                "pos": 2,
                                "url": "https://www.tiktok.com/@kaorihatsusee/video/7501124173717065006",
                                "title": "Honestly enjoyed our stay here 🫶🏼 @maya hangai 📍Kasa La Monarca, San Francisco #affordable #affordablehotel #hotel #sanfrancisco"
                                "source": "TikTok",
                                "engagement_timeframe": "45.3K+views, 3 weeks ago"
                            },
                            {
                                "pos": 3,
                                "url": "https://www.cntraveler.com/gallery/best-hotels-in-san-francisco",
                                "title": "23 Best Hotels in San Francisco, From Mission Bay to the Castro District"
                                "source": "Condé Nast Traveller",
                                "engagement_timeframe": "1 month ago"
                            }
                        ]
                    }
...
```

<table><thead><tr><th width="279">Key (results.what_people_are_saying)</th><th width="256">Description</th><th width="91">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list containing all discussion forum or social media content items.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url</code></td><td>The URL of the discussion thread or social media content page.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.title</code></td><td>The title of the discussion thread or content piece.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.top_comments</code></td><td>The top comment from the discussion thread, if displayed.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.source</code></td><td>The name of the platform or website hosting the content.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.engagement_timeframe</code></td><td>Comment count and activity timeframe (e.g., "45 comments, 2 days ago").</td><td>string</td><td>Desktop and Mobile</td></tr></tbody></table>

### Search Information

The `search_information` feature provides structured information on the search query.

<figure><img src="/files/dFpTGCDTtNbDNPNmTQHI" alt=""><figcaption></figcaption></figure>

```json
...
"search_information": {
    "query": "restaurants",
    "geo_location": "10007, New York, NY",
    "showing_results_for": "restaurants",
    "total_results_count": 3200000000
},
...
```

<table><thead><tr><th width="290">Key (results.search_information)</th><th width="242">Description</th><th width="95">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>query</code></td><td>The original search term.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>geo_location</code> *</td><td>Indicates the specific geographical area associated with the search.</td><td>string</td><td>Desktop</td></tr><tr><td><code>showing_results_for</code></td><td>The search term the search results are shown for. `query` and `showing_results_for` may differ if Google auto-corrected the provided search term.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>total_results_count</code></td><td>The total number of results found for the search term.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

\*Works only with JS rendering

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

<figure><img src="https://lh7-us.googleusercontent.com/6YYs9-sKUuWwqFenkyqlNQVpzA60wY1dTSU2YOB0-5Y8-QU-3ed7IPFmjUbWtrbsewBO37BAQVwlGr9iRk1izSKIfZDgPr1GyZYZK4D5QLySs1jTYuQGfEVBxsdtPrUQXAWuOMStLbtCRjiBN7s7g70" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="252">Key (results.item_carousel)</th><th width="293">Description</th><th width="93">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of items placed in a carousel with their respective details.</td><td>array</td><td>Desktop</td></tr><tr><td><code>items.pos</code></td><td>The position of the item within the carousel.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>items.href</code></td><td>A hyperlink to the Google SERP of the item in the carousel.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.title</code></td><td>The name/title of the entity in the carousel.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.subtitle</code></td><td>Additional details about the entity in the title.</td><td>string</td><td>Desktop</td></tr><tr><td><code>title</code></td><td>The title of the carousel section. The title is related to the search query.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Item Carousel result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

### Recipes

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

<figure><img src="https://lh7-us.googleusercontent.com/0ZyTLJUnZp70QpENO34_Z6ti-M7xlCDmkc3opFsId3uIP9ce7nBwyiAyVN1z-3XK-S0ZDjXMkFq1QBfamVHEBxYi1JZlXuzB9lMRjeOfLeNVRTX6U_6rDi4e9Nxp5-c4eSh71osP1HtMMmauBdpgLrY" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="199">Key (results.recipes)</th><th width="299">Description</th><th width="119">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of selected recipes with their respective details.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>The position of the recipe within the Recipes SERP feature.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url</code></td><td>The URL to the full recipe.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.desc</code></td><td>A short description of the recipe retrieved from the original article.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.title</code></td><td>The title of the recipe.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.rating</code></td><td>The rating of the recipe.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.source</code></td><td>The name of the website where the recipe is located.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.duration</code></td><td>The time that is needed to prepare the dish.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Recipes result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/9L4k95MzrvQYTronwCU7re362ROCizIeN9deJb2Kg58pLOn87_07ABu0x1Ui5iFGTi83ouCsqYPMsnksyn0xRKsJbJg-I9VOLBu6ryK3Jv8nv-upjmHhilTBh5Angr-4OX9ZxGMp8Wh2OAeTgRi8Mh4" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="193">Key (results.videos)</th><th width="325">Description</th><th width="90">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list containing all of the video section results.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>items.pos</code></td><td>The position of the video inside the list.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>items.url</code></td><td>A link to the video.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.title</code></td><td>The title of the video.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.author</code></td><td>The name of the profile where the video had been uploaded.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>items.source</code></td><td>The name of the platform hosting the video.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Videos result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="/files/VpgL4ytA2DbZ9cPaXT1t" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="272">Key (results.featured_snippet)</th><th width="263">Description</th><th width="98">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>url</code></td><td>The URL of the website from which the snippet describing the page is retrieved.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>desc</code></td><td>The snippet containing a description for a specific search result.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>title</code></td><td>The name of the article from which the snippet describing a page is retrieved.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>url_shown</code></td><td>The URL of the website containing the featured snippet that is visible in the SERP.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Featured Snippet result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

<table><thead><tr><th width="252">Key (results.related_searches_categorized)</th><th width="307">Description</th><th width="88">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list containing all of the related searches items retrieved from a horizontal carousel within the SERP.</td><td>array</td><td>Desktop</td></tr><tr><td><code>items.url</code></td><td>The URL of the related search page.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.title</code></td><td>The name of the related search result rendered in the browser.</td><td>string</td><td>Desktop</td></tr><tr><td><code>category</code></td><td>An object containing more details regarding the category of the related search results.</td><td>object</td><td>Desktop</td></tr><tr><td><code>category.name</code></td><td>The name of the category.</td><td>string</td><td>Desktop</td></tr><tr><td><code>category.type</code></td><td>The type of the related search section.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Related Searches Categorized result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/iPDd_EcJghCWQBCzYfx8ZAUx4C6ueDoKYzfJYcjg_5fBCzwzp2ifJ-8z6-Pxyob_Uoh6SSDXILq0pXki-0PMG80zvq7v8aRZ1rBxJlK1_7lEElNF84VghCnyeKxV2acKFfXuergKmOtsYd_uYUmzBAc" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="241">Key (results.hotels)</th><th width="309">Description</th><th width="89">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>date_to</code></td><td>The date of the check-out.</td><td>string</td><td>Desktop</td></tr><tr><td><code>results</code></td><td>A list with all of the hotel's details.</td><td>array</td><td>Desktop</td></tr><tr><td><code>results.price</code></td><td>The price of the hotel.</td><td>string</td><td>Desktop</td></tr><tr><td><code>results.title</code></td><td>The name of the hotel.</td><td>string</td><td>Desktop</td></tr><tr><td><code>results.description</code></td><td>A short description of the hotel visible just below the name of the hotel.</td><td>string</td><td>Desktop</td></tr><tr><td><code>date_from</code></td><td>The date of the check-in.</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Hotels result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="/files/TWchj6RvIGzcpHSYNY6P" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="210">Key (results.flights)</th><th width="311">Description</th><th width="105">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>to</code></td><td>The airport of arrival.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>from</code></td><td>The airport of departure.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>date_to</code></td><td>The day of the arrival.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>results</code></td><td>A list of selected flights with their respective details.</td><td>array</td><td>Desktop and Mobile</td></tr><tr><td><code>results.url</code></td><td>A link to Google Flights page listing all flights from a single airline.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>results.type</code></td><td>The type of the flight.</td><td>string</td><td>Desktop</td></tr><tr><td><code>results.price</code></td><td>The price of the flight.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>results.airline</code></td><td>The name of the carrier.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>results.duration</code></td><td>The duration of the flight.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>date_from</code></td><td>The date of the departure.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Flights result within the SERP.</td><td>integer</td><td>Desktop and Mobile</td></tr></tbody></table>

### Video Box

The `video_boxes` array includes specific video results at the top of the search results page, chosen by Google as the most relevant for the query.

<figure><img src="/files/upfn32haXfd7L5CymgWC" alt=""><figcaption></figcaption></figure>

```json
...
"video_boxes": [
  {
    "pos_overall": 1,
    "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K ...",
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  },
  {
    "pos_overall": 2,
    "title": "Rick Astley - Never Gonna Give You Up 1987 (Official Music ...",
    "url": "https://www.youtube.com/watch?v=jzmz6K8K4L0"
  }
]
...
```

<table><thead><tr><th width="223">Key (results.video_boxes)</th><th width="294">Description</th><th width="93">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>pos_overall</code></td><td>The overall position of the Video Box.</td><td>integer</td><td>Desktop and Mobile</td></tr><tr><td><code>title</code></td><td>The title of the video.</td><td>string</td><td>Desktop and Mobile</td></tr><tr><td><code>url</code></td><td>The URL of the video.</td><td>string</td><td>Desktop and Mobile</td></tr></tbody></table>

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

<figure><img src="https://lh7-us.googleusercontent.com/yadrS_2-ZIIAUn3iwOUzStEs9VFSgW5w_BaipvjB1ms-ltGE3-HZA3EUTCw5f_adQAOeiq8eXxtehBW9PEfiastiJWvOCPGige8dq___mWUuHd7jQ3SkWuXlfz6hRyYr0CLP09y-CvObwwIz2Xu1uFI" alt=""><figcaption></figcaption></figure>

<pre class="language-json"><code class="lang-json"><strong>...
</strong><strong>"local_service_ads": {
</strong>    "items": [
        {
            "pos": 1,
            "url": "/localservices/prolist?g2lbs=...=accident+lawyer",
            "title": "Crandall &#x26; Katt, Attorneys at Law",
            "rating": 4.4,
            "reviews_count": 254,
        },
       ...
    ],
    "pos_overall": 2
},
...
</code></pre>

<table><thead><tr><th width="278">Key (results.local_service_ads)</th><th width="264">Description</th><th width="106">Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>A list of service providers with their respective details.</td><td>array</td><td>Desktop</td></tr><tr><td><code>items.pos</code></td><td>The position of the service ad within the Local Services Ads SERP feature.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>items.url</code></td><td>A link to the service in the Local Services search page.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.title</code></td><td>The title of the service provider.</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.rating</code></td><td>The rating of the service provider.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>items.reviews_count</code></td><td>The number of reviews for the service provider.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Local Service Ads result within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

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

<figure><img src="/files/uGntm9EcQ8xRpdMEEZY5" alt=""><figcaption></figcaption></figure>

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

<table><thead><tr><th width="241">Key (results.apps)</th><th width="304">Description</th><th>Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>id</code></td><td>The id of the application within the available app store.</td><td>string</td><td>Mobile</td></tr><tr><td><code>url</code></td><td>The URL of the application store containing full information about the application in the SERP.</td><td>string</td><td>Mobile</td></tr><tr><td><code>title</code></td><td>The title of the application.</td><td>string</td><td>Mobile</td></tr><tr><td><code>rating</code></td><td>The rating of the application.</td><td>integer</td><td>Mobile</td></tr><tr><td><code>reviews_count</code></td><td>The total number of reviews available for the Apps SERP result in the application store.</td><td>integer</td><td>Mobile</td></tr><tr><td><code>items.reviews_count</code></td><td>The number of reviews for the service provider.</td><td>string</td><td>Mobile</td></tr></tbody></table>

### **Finance**

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

#### **HTML example**

<figure><img src="/files/HssKJHKUnA0lwf6NLt5A" alt=""><figcaption></figcaption></figure>

| Key (results.finance) | Description                                                                                  | Type   | Layout  |
| --------------------- | -------------------------------------------------------------------------------------------- | ------ | ------- |
| `low`                 | The low price for the specified date.                                                        | float  | Desktop |
| `date`                | The date at which the net asset value was reported.                                          | string | Desktop |
| `high`                | The high price for the specified date                                                        | float  | Desktop |
| `open`                | The opening price for the specified date                                                     | float  | 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                                                                        | float  | Desktop |
| `52_week_high`        | The 52-week high price                                                                       | float  | 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 | float  | Desktop |
| `price_earning_ratio` | The price to earning ratio of the stock                                                      | float  | Desktop |

#### JSON sample

```json
...                   
"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**

<figure><img src="https://lh7-us.googleusercontent.com/k9sU3gTgnIWx2WvAP7-TvMvinUfmLrq2HVOHo-z5Ol51T1th9gYNxuxDv72ZV-m2tLMhM1xqNktZD7VJ5N3FFcour8jMaJlc3z4F3sdKhZppBbPz-NQCfZWn9ONwL0NXBg_8c6z26kaGNF8sz9hP1K8" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="231">Key (results.sports_games)</th><th width="271">Description</th><th>Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>games</code></td><td>An array which provides information about a number of sports games</td><td>array</td><td>Desktop</td></tr><tr><td><code>games.date</code></td><td>The date and time when the game is scheduled to take place or when it occurred</td><td>string</td><td>Desktop</td></tr><tr><td><code>games.teams</code></td><td>The teams involved in the game</td><td>array</td><td>Desktop</td></tr><tr><td><code>games.game_type</code></td><td>The type of game being played, such as a regular season match, playoff game, championship game, etc.</td><td>string</td><td>Desktop</td></tr><tr><td><code>games.highlight</code></td><td>A link to notable highlights from the game, such as key plays, goals, etc.</td><td>string</td><td>Desktop</td></tr><tr><td><code>games.teams.score</code></td><td>The scores or points earned by each team during the game</td><td>string</td><td>Desktop</td></tr><tr><td><code>games.teams.winner</code></td><td>Specifies which team won the game</td><td>boolean</td><td>Desktop</td></tr><tr><td><code>games.teams.team_name</code></td><td>Displays the names of the teams involved in the game</td><td>string</td><td>Desktop</td></tr><tr><td><code>stage</code></td><td>The specific phase or stage of a sports competition or tournament.</td><td>string</td><td>Desktop</td></tr><tr><td><code>league</code></td><td>Refers to the sports league or organization overseeing the competition</td><td>string</td><td>Desktop</td></tr></tbody></table>

#### **JSON sample**

```json
...                 
"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**

<figure><img src="/files/BR8pEnNAz9aHX3WoWkAs" alt=""><figcaption></figcaption></figure>

<table><thead><tr><th width="202">Key (results.discussions_and_forums)</th><th width="360">Description</th><th>Type</th><th>Layout</th></tr></thead><tbody><tr><td><code>items</code></td><td>An array of items or entries within a forum or discussion thread that Google has indexed</td><td>array</td><td>Desktop</td></tr><tr><td><code>items.pos</code></td><td>An indicator denoting the position of a given item among all Discussions and Forums results.</td><td>integer</td><td>Desktop</td></tr><tr><td><code>items.url</code></td><td>The URL link to the specific forum post or discussion thread</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.title</code></td><td>The title or headline of the forum post or discussion topic</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.source</code></td><td>The source which hosts the forum or discussion</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.timeframe</code></td><td>The timeframe or date of the forum post or discussion</td><td>string</td><td>Desktop</td></tr><tr><td><code>items.comments_count</code></td><td>The number of comments or replies the forum post or discussion thread has received</td><td>string</td><td>Desktop</td></tr><tr><td><code>pos_overall</code></td><td>An indication of the position of the Discussions and Forums SERP feature within the SERP.</td><td>integer</td><td>Desktop</td></tr></tbody></table>

#### **JSON sample**

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/api-targets/search-engines/google/search/search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
