# Pesquisa de notícias

O `google_search` source é projetado para recuperar resultados do Google Search (SERPs). Esta subpágina apresenta especificamente dados relacionados ao Google News Search. Para explorar outros tipos de resultados, leia aqui: [**Pesquisa na Web**](https://github.com/oxylabs/gitbook-public-english/blob/master/scraping-solutions/web-scraper-api/targets/google/search/broken-reference/README.md), [**Pesquisa de Imagens**](https://github.com/oxylabs/gitbook-public-english/blob/master/scraping-solutions/web-scraper-api/targets/google/search/broken-reference/README.md).

{% hint style="warning" %}
Para rastrear a pesquisa do Google News, inclua o `context:udm` parâmetro com o valor definido como `12` ou `context:tbm` parâmetro com o valor definido como `pts`.
{% endhint %}

{% hint style="info" %}
Explorar saída [**dicionário de dados de saída**](#data-dictionary) para cada recurso de SERP de Notícias, oferecendo uma breve descrição, captura de tela, trecho de código JSON analisado e uma tabela definindo cada campo analisado. Navegue pelos detalhes usando a navegação à direita ou rolando a página para baixo.
{% endhint %}

## Exemplos de requisição

Nos exemplos abaixo, fazemos uma solicitação para obter páginas de resultados de pesquisa do News para o termo de busca `adidas`.

### o parâmetro permite alternar entre diferentes guias de busca, como imagens, locais ou vídeos, para personalizar o tipo de resultados exibidos. Encontre os valores aceitos

{% 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",
        "parse": true,
        "context": [
            {
                "key": "udm",
                "value": "12"
            }
        ]
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Estruturar o payload.
payload = {
    'source': 'google_search',
    'query': 'adidas',
    'parse': True,
    'context': [
        {'key': 'udm', 'value': '12'},
    ],
}

# Obter resposta.
response = requests.post(
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Imprimir a resposta formatada no 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",
    parse: true,
    context: [
        { key: "udm", value: "12" },
    ],
};

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
source=google_search&query=adidas&parse=true&context[0][key]=udm&context[0][value]=12&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'google_search',
    'query' => 'adidas',
    'parse' => true,
    'context' => [
        [
            'key' => 'udm',
            'value' => '12',
        ]
    ]
);

$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",
		"parse":  true,
		"context": []map[string]interface{}{
			{"key": "udm", "value": "12"},
		},
	}

	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",
                parse = true,
                context = new dynamic [] {
                    new { key = "udm", value = "12" },
                }
            };

            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("parse", true);
        jsonObject.put("context", new JSONArray()
                .put(new JSONObject()
                        .put("key", "udm")
                        .put("value", "12"))
        );

        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",
    "parse": true,
    "context": [
        {
            "key": "udm",
            "value": "12"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

### Parâmetro to-be-matched ou

{% 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",
        "parse": true,
        "context": [
            {
                "key": "tbm",
                "value": "nws"
            }
        ]
    }'
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
from pprint import pprint

# Estruturar o payload.
payload = {
    'source': 'google_search',
    'query': 'adidas',
    'parse': True,
    'context': [
        {'key': 'tbm', 'value': 'nws'},
    ],
}

# Obter resposta.
response = requests.post(
    'https://realtime.oxylabs.io/v1/queries',
    auth=('USERNAME', 'PASSWORD'),
    json=payload,
)

# Imprimir a resposta formatada no 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",
    parse: true,
    context: [
        { key: "tbm", value: "nws" },
    ],
};

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
source=google_search&query=adidas&parse=true&context[0][key]=tbm&context[0][value]=nws&access_token=12345abcde
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

$params = array(
    'source' => 'google_search',
    'query' => 'adidas',
    'parse' => true,
    'context' => [
        [
            'key' => 'tbm',
            'value' => 'nws',
        ]
    ]
);

$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",
		"parse":  true,
		"context": []map[string]interface{}{
			{"key": "tbm", "value": "nws"},
		},
	}

	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",
                parse = true,
                context = new dynamic [] {
                    new { key = "tbm", value = "nws" },
                }
            };

            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("parse", true);
        jsonObject.put("context", new JSONArray()
                .put(new JSONObject()
                        .put("key", "tbm")
                        .put("value", "nws"))
        );

        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",
    "parse": true,
    "context": [
        {
            "key": "tbm",
            "value": "nws"
        }
    ]
}
```

{% endtab %}
{% endtabs %}

Usamos [**Realtime**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods/realtime) método de integração em nossos exemplos. Se você quiser usar [**Proxy Endpoint**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods/proxy-endpoint) ou assíncrona [**Push-Pull**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods/push-pull) integração, consulte o [**métodos de integração**](https://developers.oxylabs.io/documentation/pt-br/solucoes-de-scraping/web-scraper-api/integration-methods) seção.

## Valores dos parâmetros da requisição

### Genérico

Configuração básica e opções de personalização para rastrear resultados de pesquisa do Google News.

<table><thead><tr><th width="222">Parâmetro</th><th width="350.3333333333333">Descrição</th><th>Valor Padrão</th></tr></thead><tbody><tr><td><mark style="background-color:green;"><strong>source</strong></mark></td><td>Define o scraper.</td><td><code>google_search</code></td></tr><tr><td><mark style="background-color:green;"><strong>query</strong></mark></td><td>A palavra-chave ou frase a ser pesquisada.</td><td>-</td></tr><tr><td><mark style="background-color:orange;"><strong>context:</strong></mark><br><mark style="background-color:orange;"><strong>o parâmetro permite alternar entre diferentes guias de busca, como imagens, locais ou vídeos, para personalizar o tipo de resultados exibidos. Encontre os valores aceitos</strong></mark></td><td>Para obter resultados de pesquisa do News, defina value como <mark style="background-color:orange;"><strong>12</strong></mark>. Encontre outros valores aceitos <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>aqui</strong></a>.</td><td></td></tr><tr><td><mark style="background-color:orange;"><strong>context:</strong></mark><br><mark style="background-color:orange;"><strong>Parâmetro to-be-matched ou</strong></mark></td><td>Para obter resultados de pesquisa do News, defina value como <mark style="background-color:orange;"><strong>pts</strong></mark>. Outros valores aceitos são: <code>blg</code>, <code>bks</code>, <code>dsc</code>, <code>isch</code>, <code>nws</code>, <code>plcs</code>, <code>rcp</code>, <code>lcl</code>, <code>tbs</code></td><td>-</td></tr><tr><td><code>render</code></td><td>Ativa a renderização JavaScript quando definido como <code>html</code>. <a href="../../../features/js-rendering-and-browser-control/javascript-rendering"><strong>Mais informações</strong></a><strong>.</strong></td><td>-</td></tr><tr><td><code>parse</code></td><td>Retorna dados analisados quando definido como <code>true</code>. Explore o <a href="#output-data-dictionary"><strong>dicionário de dados de saída</strong></a>.</td><td><code>false</code></td></tr><tr><td><code>callback_url</code></td><td>URL para seu endpoint de callback. <a href="../../../../integration-methods/push-pull#callback"><strong>Mais informações</strong></a>.</td><td>-</td></tr><tr><td><code>user_agent_type</code></td><td>Tipo de dispositivo e navegador. A lista completa pode ser encontrada <a href="../../../features/http-context-and-job-management/user-agent-type"><strong>aqui</strong></a>.</td><td><code>desktop</code></td></tr></tbody></table>

&#x20;   \- parâmetro obrigatório

\- `o parâmetro permite alternar entre diferentes guias de busca, como imagens, locais ou vídeos, para personalizar o tipo de resultados exibidos. Encontre os valores aceitos` e `Parâmetro to-be-matched ou` parâmetros context não podem ser usados juntos em uma única requisição de scraping; **por favor selecione um deles**. Usar ambos simultaneamente pode levar a conflitos ou comportamento inesperado.

#### Operadores avançados de busca do Google

Ao raspar, pode ser útil combinar operadores avançados de busca do Google com sua consulta. Isso permite personalizar o escopo da busca, garantindo resultados mais relevantes e focados. Explore esses comandos especiais [**aqui**](https://ahrefs.com/blog/google-advanced-search-operators/) e [**aqui**](https://www.semrush.com/kb/831-how-to-use-google-advanced-search-operators). Veja um exemplo abaixo.

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

### Localização

Adapte os resultados da pesquisa a locais geográficos e idiomas específicos.

<table><thead><tr><th width="222">Parâmetro</th><th width="350.3333333333333">Descrição</th><th>Valor Padrão</th></tr></thead><tbody><tr><td><code>geo_location</code></td><td>A localização geográfica para a qual o resultado deve ser adaptado. Usar este parâmetro corretamente é extremamente importante para obter os dados certos. Para mais informações, leia sobre nossas <code>geo_location</code> estruturas de parâmetro <a href="../../../../features/localization/serp-localization#google"><strong>aqui</strong></a><strong>.</strong></td><td>-</td></tr><tr><td><code>locale</code></td><td><code>Accept-Language</code> valor do cabeçalho que altera o idioma da interface da página de pesquisa do Google. <a href="../../../../features/localization/domain-locale-results-language#locale-1"><strong>Mais informações</strong></a>.</td><td>-</td></tr></tbody></table>

### Paginação

Controles para gerenciar a paginação e a recuperação dos resultados de pesquisa.

<table><thead><tr><th width="222">Parâmetro</th><th width="350.3333333333333">Descrição</th><th width="167">Valor Padrão</th></tr></thead><tbody><tr><td><code>start_page</code></td><td>Número da página inicial.</td><td><code>1</code></td></tr><tr><td><code>pages</code></td><td>Número de páginas a serem recuperadas.</td><td><code>1</code></td></tr><tr><td><code>limit</code></td><td>Número de resultados a recuperar em cada página.</td><td><code>10</code></td></tr><tr><td><p><code>context</code>:</p><p><code>Raspe várias páginas usando o mesmo endereço IP e sessão (conjunto de cookies). Especificando os números de página em um array JSON com a</code></p></td><td>Se você quiser raspar várias páginas com o mesmo endereço IP, inclua um array JSON e especifique os números das páginas usando o <code>chave e indicando o número de resultados orgânicos por página usando a</code> key. Você também deve indicar o número de resultados orgânicos em cada página adicionando um <code>limit</code> key. <a href="#limit-per-page"><strong>Suporte a rolagem contínua</strong></a><strong>.</strong></td><td>-</td></tr></tbody></table>

#### Devido a mudanças recentes nos limites do Google, ajustamos o comportamento da Web Scraper API. O máximo de resultados por página corresponderá à saída orgânica do Google, que normalmente é de 10 resultados.

Exemplo

<table><thead><tr><th width="142">Parâmetro</th><th width="446.3333333333333">Descrição</th><th>O número da página que você gostaria de raspar. Qualquer valor inteiro maior que</th></tr></thead><tbody><tr><td><code>chave e indicando o número de resultados orgânicos por página usando a</code></td><td>funcionará <code>0</code> O número de resultados na página em questão. Qualquer valor inteiro entre</td><td><code>1</code></td></tr><tr><td><code>limit</code></td><td>(inclusivo) funcionará. <code>1</code> e <code>100</code> Exemplo de requisição</td><td><code>90</code></td></tr></tbody></table>

#### "key": "limit\_per\_page",

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

### Opções para filtrar e refinar resultados de busca com base em vários critérios. Aprenda a usar parâmetros de contexto

Opções para filtrar e refinar resultados de pesquisa com base em vários critérios.

<table><thead><tr><th width="245">Parâmetro</th><th width="350.3333333333333">Descrição</th><th>Valor Padrão</th></tr></thead><tbody><tr><td><code>context</code>:<code>Pesquisa segura. Defina como</code></td><td>para habilitá-la. <code>true</code> udm</td><td><code>false</code></td></tr><tr><td><code>context</code>:<br><code>Este parâmetro é como um contêiner para parâmetros do Google mais obscuros, como limitar/ordenar resultados por data, além de outros filtros, alguns dos quais dependem do</code></td><td><code>Este parâmetro é como um contêiner para parâmetros do Google mais obscuros, como limitar/ordenar resultados por data, além de outros filtros, alguns dos quais dependem do</code> parâmetro. Este parâmetro é como um contêiner para parâmetros do Google mais obscuros, como limitar/ordenar resultados por data, além de outros filtros, alguns dos quais dependem do <code>Parâmetro to-be-matched ou</code> tbs=app_os:1 <code>só está disponível com</code> value <code>Parâmetro to-be-matched ou</code> value <code>blg</code>os parâmetros de contexto não podem ser usados juntos em uma única requisição de scraping; por favor selecione apenas um. Usar ambos simultaneamente pode levar a conflitos ou comportamento inesperado. <a href="https://stenevang.wordpress.com/2013/02/22/google-advanced-power-search-url-request-parameters/"><strong>aqui</strong></a>.</td><td>-</td></tr></tbody></table>

### Outros

Configurações avançadas adicionais e controles para requisitos especializados.

<table><thead><tr><th width="222">Parâmetro</th><th width="350.3333333333333">Descrição</th><th>Valor Padrão</th></tr></thead><tbody><tr><td><code>context</code>:<br><code>nfpr</code></td><td><code>true</code> desativará a autocorreção ortográfica</td><td><code>false</code></td></tr></tbody></table>

### Parâmetros de contexto

Todos os parâmetros de contexto devem ser adicionados ao `context` array como objetos com `key` e `value` pares, por exemplo:

```json
...
"context": [
    {
        "key": "filter",
        "value": "0"
    }
]
...
```

## Dados estruturados

SERP Scraper API é capaz de extrair um objeto HTML ou JSON que contém resultados de pesquisa do Google, oferecendo dados estruturados sobre vários elementos da página de resultados.

<details>

<summary><code>google_search</code> saída estruturada de notícias</summary>

```json
{
    "results": [
        {
            "content": {
                "url": "https://www.google.com/search?q=adidas&tbm=nws&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
                "page": 1,
                "results": {
                    "main": [
                        {
                            "url": "https://www.cnn.com/2022/05/06/business/under-armour-stock-adidas-nike/index.html",
                            "desc": "Cadeias de suprimentos atrapalhadas e uma onda de coronavírus na China estão causando \ndores de cabeça para as principais marcas esportivas.",
                            "title": "Wall Street está irritada com Under Armour, Nike e Adidas",
                            "source": "CNN",
                            "pos_overall": 1,
                            "relative_publish_date": "há 2 dias"
                        },
                        ...
                        {
                            "url": "https://www.cnbc.com/2022/05/06/dsw-tests-layout-to-spotlight-brands-like-adidas-crocs-birkenstock.html",
                            "desc": "A DSW está testando um novo visual e layout de loja em um local que abre este \nfim de semana em Houston, numa tentativa de focar a atenção dos clientes em...",
                            "title": "A DSW está testando um layout de loja que coloca os holofotes em marcas como \nAdidas, Crocs e Birkenstock",
                            "source": "CNBC",
                            "pos_overall": 10,
                            "relative_publish_date": "há 2 dias"
                        }
                    ],
                    "total_results_count": 57300000
                },
                "parse_status_code": 12000
            },
            "created_at": "2022-05-09 07:25:03",
            "updated_at": "2022-05-09 07:25:07",
            "page": 1,
            "url": "https://www.google.com/search?q=adidas&tbm=nws&uule=w+CAIQICINdW5pdGVkIHN0YXRlcw&gl=us&hl=en",
            "job_id": "6929330379711060993",
            "status_code": 200,
            "parser_type": "v2"
        }
    ]
}
```

</details>

{% hint style="info" %}
Nós apenas analisamos resultados de pesquisa de notícias para **desktop** pesquisas.
{% endhint %}

## Dicionário de dados de saída

#### Exemplo de HTML

<figure><img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FSxmNbXjudpsJ4VcregnQ%2Fgoogle_news_search.png?alt=media&#x26;token=0453c806-368e-459e-ae54-78b434cbc250" alt=""><figcaption></figcaption></figure>

#### Estrutura JSON

A saída estruturada do Google News Search inclui campos como `URL`, `chave e indicando o número de resultados orgânicos por página usando a`, `resultados`, e outros. A tabela abaixo apresenta uma lista detalhada de cada recurso do SERP que analisamos, junto com sua descrição e tipo de dado. A tabela também inclui alguns metadados.

{% hint style="info" %}
O número de itens e campos para um tipo de resultado específico pode variar dependendo da consulta de pesquisa.
{% endhint %}

<table><thead><tr><th width="265">Chave</th><th width="368.3333333333333">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>url</code></td><td>A URL da página de pesquisa do Google.</td><td>string</td></tr><tr><td><code>resultados</code></td><td>Um dicionário contendo os resultados da pesquisa.</td><td>array</td></tr><tr><td><code>results.main</code></td><td>Uma lista de resultados de notícias não pagos com seus respectivos detalhes.</td><td>array</td></tr><tr><td><code>results.additional</code></td><td>Uma lista de artigos em tendência com seus respectivos detalhes.</td><td>object</td></tr><tr><td><code>results.total_results_count</code></td><td>O número total de resultados encontrados para a consulta de pesquisa.</td><td>array</td></tr><tr><td><code>parse_status_code</code></td><td>O código de status do trabalho de parsing. Você pode ver os códigos de status do parser descritos <a href="https://github.com/oxylabs/gitbook-public-english/blob/master/scraping-solutions/web-scraper-api/targets/google/search/broken-reference/README.md"><strong>aqui</strong></a>.</td><td>integer</td></tr><tr><td><code>created_at</code></td><td>O timestamp quando o trabalho de scraping foi criado.</td><td>timestamp</td></tr><tr><td><code>updated_at</code></td><td>O timestamp quando o trabalho de scraping foi finalizado.</td><td>timestamp</td></tr><tr><td><code>chave e indicando o número de resultados orgânicos por página usando a</code></td><td>Número da página relativo à paginação do SERP do Google.</td><td>integer</td></tr><tr><td><code>job_id</code></td><td>O ID do job associado ao trabalho de scraping.</td><td>string</td></tr><tr><td><code>status_code</code></td><td>O código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos <a href="https://github.com/oxylabs/gitbook-public-english/blob/master/scraping-solutions/web-scraper-api/targets/google/search/broken-reference/README.md"><strong>aqui</strong></a>.</td><td>integer</td></tr></tbody></table>

{% hint style="info" %}
Nas seções a seguir, os trechos de código JSON analisados são encurtados quando há mais de um item disponível para o tipo de resultado.
{% endhint %}

### Principal

Exibe uma lista de resultados de notícias não pagos, fornecendo detalhes relevantes para cada artigo.

<figure><img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FPubsRUBP8Jq7MTMBax9g%2Fgoogle_news_search_3.png?alt=media&#x26;token=a36bcefb-fc14-4024-899d-517350b61fdf" alt=""><figcaption></figcaption></figure>

```json
...
"main": [
    {
        "url": "https://www.yahoo.com/lifestyle/tiger-woods-nikes-epic-partnership-015311819.html",
        "desc": "Que poderia existir um mundo em que Tiger Woods não fosse patrocinado pela \nNike parecia...",
        "title": "Como a épica parceria entre Tiger Woods e a Nike desmoronou",
        "source": "Yahoo",
        "pos_overall": 1,
        "relative_publish_date": "há 1 dia"
    },
                       ...
},

...
```

<table><thead><tr><th width="260.3333333333333">Chave (results.main)</th><th width="317">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>url</code></td><td>O URL para o artigo completo.</td><td>string</td></tr><tr><td><code>desc</code></td><td>Um trecho curto do artigo completo.</td><td>string</td></tr><tr><td><code>title</code></td><td>O título do artigo.</td><td>string</td></tr><tr><td><code>source</code></td><td>O nome do site onde o artigo foi publicado.</td><td>string</td></tr><tr><td><code>pos_overall</code></td><td>Indica a posição geral do resultado dentro dos resultados principais da SERP de Notícias.</td><td>integer</td></tr><tr><td><code>relative_publish_date</code></td><td>Descreve há quanto tempo o artigo foi publicado.</td><td>string</td></tr></tbody></table>

### Adicional

Apresenta uma lista de artigos em tendência, acompanhada de detalhes relevantes.

<figure><img src="https://1214208351-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FijqjTbDfWASz2pRsCwdr%2Fgoogle_news_search_2.png?alt=media&#x26;token=33ec1e0d-54dd-4d1d-bd08-e337fd3b2f2e" alt=""><figcaption></figcaption></figure>

```json
...
"additional": [
    {
        "items": [
            {
                "pos": 1,
                "url": "https://www.complex.com/sneakers/a/brendan-dunne/nike-book-1-colorways-haven-hike-rattlesnake",
                "title": "Nike Book 1 Colorways Haven Hike Rattlesnake",
                "source": "Complex",
                "relative_publish_date": "há 1 dia"
            },
         ...
        ],
        "pos_overall": 2,
        "section_title": "Devin Booker confirma problemas com o lançamento do Nike Book 1"
    }
...
```

<table><thead><tr><th width="265.3333333333333">Chave (results.additional)</th><th width="366">Descrição</th><th>Tipo</th></tr></thead><tbody><tr><td><code>itens</code></td><td>Uma lista de artigos com seus respectivos detalhes.</td><td>array</td></tr><tr><td><code>items.pos</code></td><td>Um indicador único que denota a posição do artigo na lista.</td><td>integer</td></tr><tr><td><code>items.url</code></td><td>O URL para o artigo completo.</td><td>string</td></tr><tr><td><code>items.title</code></td><td>O título do artigo.</td><td>string</td></tr><tr><td><code>items.source</code></td><td>O nome do site onde o artigo foi publicado.</td><td>string</td></tr><tr><td><code>items.relative_publish_date</code></td><td>Descreve há quanto tempo o artigo foi publicado.</td><td>string</td></tr><tr><td><code>pos_overall</code></td><td>Indica a posição geral do resultado dentro dos resultados adicionais da SERP de Notícias.</td><td>integer</td></tr><tr><td><code>section_title</code></td><td>O nome da seção adicional.</td><td>string</td></tr></tbody></table>


---

# 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/documentation/pt-br/solucoes-de-scraping/web-scraper-api/targets/google/search/news-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.