Aprenda como usar esta fonte para máxima visibilidade de anúncios pagos.
O google_ads a fonte é otimizada para recuperar resultados do Google Search (SERPs) e Google AI Overviews com anúncios pagos em um taxa máxima de anúncios. A fonte retornará apenas dez resultados por página, garantindo as maiores chances de exibição de resultados pagos. Fora isso, ela suporta os mesmos parâmetros que o WebSearch.
Exemplos de requisição
Neste exemplo, fazemos uma requisição para recuperar resultados de busca pela palavra-chave adidas.
Tipo de dispositivo e navegador. A lista completa pode ser encontrada aqui.
desktop
- parâmetro obrigatório
Localização
Adapte os resultados da pesquisa a locais geográficos e idiomas específicos.
Parâmetro
Descrição
Valor Padrão
geo_location
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 geo_location estruturas de parâmetro aqui.
-
locale
Accept-Language valor do cabeçalho que altera o idioma da interface da página de pesquisa do Google. Mais informações.
-
context:
results_language
Idioma dos resultados. A lista de idiomas do Google suportados pode ser encontrada aqui.
-
Paginação
Controles para gerenciar a paginação e a recuperação dos resultados de pesquisa.
Parâmetro
Descrição
Valor Padrão
start_page
Número da página inicial.
1
pages
Número de páginas a serem recuperadas.
1
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.
Parâmetro
Descrição
Valor Padrão
context:
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
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 tbm aqui.
context:
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
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 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 Parâmetro to-be-matched ou tbs=app_os:1 só está disponível com value Parâmetro to-be-matched ou value blgos 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. aqui.
-
Outros
Configurações avançadas adicionais e controles para requisitos especializados.
Parâmetro
Descrição
Valor Padrão
context:
nfpr
true desativará a autocorreção ortográfica
false
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:
Exemplo de saída
google_ads saida estruturada
Dicionário de saída
google_ads a saída inclui campos como URL, página, resultados e mais. A tabela abaixo apresenta uma lista detalhada de cada elemento do Google Ads Max que analisamos, incluindo descrição, tipo de dado e metadados relevantes.
O número de itens e campos para um tipo de resultado específico pode variar dependendo da consulta de pesquisa.
Nome da Chave
Descrição
Tipo
url
A URL da página de resultados de busca do Google.
string
chave e indicando o número de resultados orgânicos por página usando a
Número da página.
integer
resultados
Um objeto contendo todos os tipos de resultado de busca.
object
results.paid
Lista de resultados de anúncios pagos com detalhes como título, descrição, URL e sitelinks.
array
results.organic
Lista de resultados orgânicos (não pagos) com título, descrição, URL e sitelinks.
array
results.images
Resultados de carrossel de imagens exibidos na página de busca.
object
results.knowledge
Dados do painel do Knowledge Graph incluindo título, descrição, imagens, factóides e buscas relacionadas.
object
results.navigation
Abas de navegação para alternar entre tipos de busca (Imagens, Vídeos, Notícias, etc.).
array
results.instant_answers
Recursos especiais ou caixas de resposta instantânea exibidas na página.
array
results.related_searches
Sugestões de busca relacionadas com suas consultas e posição.
object
results.search_information
Metadados sobre a busca incluindo a consulta e o total de resultados.
object
results.total_results_count
Número total estimado de resultados para a consulta.
integer
parse_status_code
Código de status da operação de parsing.
integer
created_at
Timestamp quando o trabalho de scraping foi criado.
timestamp
updated_at
Timestamp quando o trabalho de scraping foi finalizado.
timestamp
job_id
ID do job associado ao trabalho de scraping.
string
status_code
Código de status do trabalho de scraping. Você pode ver os códigos de status do scraper descritos aqui.
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_ads",
query = "adidas",
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);
}
}
}
package org.example;
import okhttp3.*;
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_ads");
jsonObject.put("query", "adidas");
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();
}
}
