Configurar tarefas de Google Organic SERP

altura da tela do navegador

campo opcional

você pode definir uma altura de tela de navegador personalizada para calcular o ranking em pixels de um dispositivo específico;

pode ser especificada dentro do seguinte intervalo: 240-9999;

por padrão, o parâmetro é definido como:

1080 para desktop;

640 para mobile no android;

812 para mobile no iOS;

Observação: para usar este parâmetro, defina calculate_rectangles como true

proporção de resolução da tela do navegador

campo opcional

você pode definir uma proporção de resolução de tela de navegador personalizada para calcular o ranking em pixels de um dispositivo específico;

pode ser especificada dentro do seguinte intervalo: 0.5-3;

por padrão, o parâmetro é definido como:

1 para desktop;

3 para mobile no android;

3 para mobile no iOS;

Observação: para usar este parâmetro, defina calculate_rectangles como true

largura da tela do navegador

campo opcional

você pode definir uma largura de tela de navegador personalizada para calcular o ranking em pixels de um dispositivo específico;

pode ser especificada dentro do seguinte intervalo: 240-9999;

por padrão, o parâmetro é definido como:

1920 para desktop;

360 para mobile no android;

375 para mobile no iOS;

Observação: para usar este parâmetro, defina calculate_rectangles como true

calcular o ranking em pixels para elementos do SERP em resultados avançados

campo opcional

o ranking em pixels se refere à distância entre o snippet do resultado e o canto superior esquerdo da tela;

Visite a Central de Ajuda para saber mais>>

por padrão, o parâmetro está definido como false

Observação: você será cobrado US$ 0,0006 a mais por usar este parâmetro

profundidade de análise

campo opcional

número de resultados na SERP

valor padrão: 10

valor máximo: 700

Sua conta será cobrada por cada SERP contendo até 10 resultados;

Definir uma profundidade acima de 10 pode gerar cobranças adicionais se o mecanismo de busca retornar mais de 10 resultados;

O custo pode ser calculado na página Preços.

tipo de dispositivo

campo opcional

retornar resultados para um tipo de dispositivo específico

pode assumir os valores:desktop, mobile

valor padrão: desktop

expandir visão geral de IA

campo opcional

defina como true para expandir o item ai_overview;

valor padrão: false;

Observação: este parâmetro se aplica apenas a resultados de tarefa HTML

tipos de elemento do SERP a verificar para destinos

campo opcional

para ativar este parâmetro, stop_crawl_on_match também precisa estar ativado

especifica quais tipos de elemento do SERP devem ser verificados para correspondências de destino

se não for especificado, todos os elementos de primeiro nível com os campos url e domain são verificados para destinos

valores possíveis: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

Observação: não pode conter os mesmos tipos de elemento que ignore_targets_in

exemplo:

"find_targets_in": ["organic", "featured_snippet"]

saiba mais sobre este parâmetro na nossa Central de Ajuda

exibir resultados relacionados

campo opcional

se definido como true, o elemento related_result na resposta será fornecido como um snippet do seu resultado orgânico pai;

se definido como false, o elemento related_result será fornecido como um resultado orgânico separado;

valor padrão: true

tipos de elemento do SERP a excluir da busca de destinos

campo opcional

para ativar este parâmetro, stop_crawl_on_match também precisa estar ativado

especifica quais tipos de elemento do SERP devem ser excluídos ao buscar correspondências de destino

valores possíveis: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter

Observação: não pode conter os mesmos tipos de elemento que find_targets_in

exemplo:

"ignore_targets_in": ["paid", "images"]

saiba mais sobre este parâmetro na nossa Central de Ajuda

palavra-chave

campo obrigatório

você pode especificar até 700 caracteres no campo keyword

todos os %## serão decodificados (o caractere ‘+’ também será decodificado como espaço)

se precisar usar o caractere “%” no seu keyword, especifique-o como “%25”;

se precisar usar o caractere “+” no seu keyword, especifique-o como “%2B”;

se este campo contiver parâmetros como ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, a cobrança por tarefa será multiplicada por 5

saiba mais sobre as regras e limitações dos campos keyword e keywords nas APIs do DataForSEO neste artigo da Central de Ajuda

código do idioma do mecanismo de busca

campo obrigatório se você não especificar language_name

se você usar este campo, não precisa especificar language_name

você pode obter a lista de idiomas disponíveis do mecanismo de busca e seus language_code fazendo uma requisição separada para https://api.dataforseo.com/v3/serp/google/languages

exemplo:

en

nome completo do idioma do mecanismo de busca

campo obrigatório se você não especificar language_code

se você usar este campo, não precisa especificar language_code

você pode obter a lista de idiomas disponíveis do mecanismo de busca e seus language_name fazendo uma requisição separada para https://api.dataforseo.com/v3/serp/google/languages

exemplo:

English

carregar visão geral de IA assíncrona

campo opcional

defina como true para obter itens ai_overview nas SERPs mesmo que sejam carregados de forma assíncrona;

se definido como false, você obterá itens ai_overview apenas do cache;

valor padrão: false

Observação: você será cobrado US$ 0,0006 a mais por usar este parâmetro;

se o elemento estiver ausente ou contiver "asynchronous_ai_overview": false, todos os valores extras serão devolvidos ao saldo da sua conta

código do local do mecanismo de busca

campo obrigatório se você não especificar location_name ou location_coordinate

se você usar este campo, não precisa especificar location_name ou location_coordinate

você pode obter a lista de locais disponíveis dos mecanismos de busca e seus location_code fazendo uma requisição separada para https://api.dataforseo.com/v3/serp/google/locations

exemplo:

2840

coordenadas GPS de um local

campo obrigatório se você não especificar location_name ou location_code

se você usar este campo, não precisa especificar location_name ou location_code

o parâmetro location_coordinate deve ser especificado no formato "latitude,longitude,radius"

o número máximo de casas decimais para "latitude" e "longitude": 7

o valor mínimo para "radius": 199 (mm)

o valor máximo para "radius": 199999 (mm)

exemplo:

53.476225,-2.243572,200

nome completo do local do mecanismo de busca

campo obrigatório se você não especificar location_code ou location_coordinate

se você usar este campo, não precisa especificar location_code ou location_coordinate

você pode obter a lista de locais disponíveis do mecanismo de busca e seus location_name fazendo uma requisição separada para https://api.dataforseo.com/v3/serp/google/locations

exemplo:

London,England,United Kingdom

tipo de correspondência de destino

campo obrigatório se stop_crawl_on_match for especificado

tipo de correspondência para o match_value

valores possíveis:

domain – domínio ou subdomínio específico

with_subdomains – domínio principal e subdomínios

wildcard – padrão curinga

domínio, subdomínio ou valor curinga de destino

campo obrigatório se stop_crawl_on_match for especificado

especifique um domínio, subdomínio ou valor curinga de destino;

Observação: o domínio ou subdomínio deve ser especificado sem protocolo de requisição;

exemplo: "match_value": "dataforseo.com",

"match_value": "/blog/post-*"

limite de páginas rastreadas

campo opcional

número de páginas de resultados de pesquisa a rastrear

valor máximo: 100

Observação: você será cobrado por cada página rastreada (10 resultados orgânicos por página);

saiba mais sobre preços na nossa página Preços;

Observação nº 2: os parâmetros max_crawl_pages e depth se complementam;

saiba mais na nossa Central de Ajuda

sistema operacional do dispositivo

campo opcional

se você especificar desktop no campo device, escolha entre os seguintes valores: windows, macos

valor padrão: windows

se você especificar mobile no campo device, escolha entre os seguintes valores: android, ios

valor padrão: android

cliques no elemento correspondente

campo opcional

especifique a profundidade de cliques no elemento people_also_ask para obter itens people_also_ask_element adicionais;

Observe que sua conta será cobrada US$ 0,00015 a mais por cada clique, independentemente da prioridade da tarefa;

se o elemento estiver ausente ou realizarmos menos cliques do que você especificou, todos os valores extras serão devolvidos ao saldo da sua conta

valores possíveis: de 1 a 4

URL de notificação de uma tarefa concluída

campo opcional

quando uma tarefa é concluída, notificaremos você por meio de uma requisição GET enviada para a URL que você especificou

você pode usar a string ‘$id’ como variável $id e ‘$tag’ como variável $tag codificada para URL. Definiremos os valores necessários antes de enviar a requisição.

exemplo:

http://your-server.com/pingscript?id=$id

http://your-server.com/pingscript?id=$id&tag=$tag

Observação: caracteres especiais em pingback_url serão codificados para URL;

entre outros, o caractere # será codificado como %23

saiba mais na nossa Central de Ajuda

tipo de dados de postback_url

campo obrigatório se você especificar postback_url

corresponde ao tipo de dados que será enviado ao seu servidor

valores possíveis:

regular, advanced, html

URL para envio dos resultados da tarefa

campo opcional

quando a tarefa for concluída, enviaremos uma requisição POST com os resultados compactados no formato gzip para o postback_url especificado

você pode usar a string ‘$id’ como variável $id e ‘$tag’ como variável $tag codificada para URL. Definiremos os valores necessários antes de enviar a requisição

exemplo:

http://your-server.com/postbackscript?id=$id

http://your-server.com/postbackscript?id=$id&tag=$tag

Observação: caracteres especiais em postback_url serão codificados para URL;

por exemplo, o caractere # será codificado como %23

saiba mais na nossa Central de Ajuda

prioridade da tarefa

campo opcional

pode assumir os seguintes valores:

1 – prioridade de execução normal (definida por padrão);

2 – prioridade de execução alta

Você será cobrado adicionalmente pelas tarefas com prioridade de execução alta.

O custo pode ser calculado na página Preços.

remover parâmetros específicos das URLs

campo opcional

usando este campo, você pode especificar até 10 parâmetros para remover das URLs no resultado

exemplo:

"remove_from_url": ["srsltid"]

domínio do mecanismo de busca

campo opcional

escolhemos automaticamente o domínio do mecanismo de busca relevante de acordo com a localização e o idioma especificados

no entanto, você pode definir um domínio personalizado do mecanismo de busca neste campo

exemplo:

google.co.uk, google.com.au, google.de, etc.

parâmetros adicionais da consulta de pesquisa

campo opcional

obtenha a lista de parâmetros disponíveis e mais detalhes aqui

Observação: os seguintes parâmetros do mecanismo de busca não são suportados e serão removidos automaticamente se especificados: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.

array de destinos para interromper o rastreamento campo opcional se especificado, a resposta conterá resultados de SERP até o match_value especificado, inclusive; você pode especificar até 10 valores de destino neste array exemplo: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] saiba mais sobre este parâmetro na nossa Central de Ajuda - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Sua conta será cobrada por cada SERP rastreada pelos destinos especificados

identificador de tarefa definido pelo usuário

campo opcional

o limite é de 255 caracteres

você pode usar este parâmetro para identificar a tarefa e associá-la ao resultado

você encontrará o valor tag especificado no objeto data da resposta

modo de correspondência de destino

campo opcional

para habilitar este parâmetro, stop_crawl_on_match também deve estar habilitado

define como o rastreamento deve parar quando vários destinos são especificados em stop_crawl_on_match

valores possíveis: all, any

all – o rastreamento para somente quando todos os destinos especificados são encontrados

any – o rastreamento para quando qualquer destino é encontrado

valor padrão: any

saiba mais sobre este parâmetro na nossa Central de Ajuda

URL direta da consulta de pesquisa

campo opcional

você pode especificar uma URL direta e nós a converteremos nos campos necessários. Observe que este método é o mais difícil para nossa API processar e também exige que você especifique o idioma e o local exatos na URL. Na maioria dos casos, não recomendamos usar este método.

exemplo:

https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

Observação: os seguintes parâmetros do mecanismo de busca não são suportados e serão removidos automaticamente se especificados na URL: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.