Sugestões de pesquisa

API + MCP

GET/v3/keywords-explorer/search-suggestions

Parâmetros de consulta

timeoutinteger

Um tempo limite manual em segundos.

limitinteger

O número de resultados a retornar. Máx.: 150000.

Padrão:1000

order_bystring

Uma coluna para ordenar os resultados. Consulte o Schema de resposta para ver os identificadores de coluna válidos, exceto volume_monthly, que não é compatível com order_by neste endpoint.

Example:field_a,field_b:asc,field_c:desc

wherestring

A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (eles diferem dos identificadores reconhecidos pelo parâmetro select).

selectstringObrigatório

Uma lista de colunas separadas por vírgulas a serem retornadas. Consulte o Schema de resposta para ver identificadores de coluna válidos.

countrystringObrigatório

Um código de país com duas letras (ISO 3166-1 alpha-2).

Valores permitidos:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

keywordsstring

Uma lista de palavras-chave separada por vírgulas para exibir métricas.

keyword_list_idinteger

O ID de uma lista de palavras-chave existente para exibir métricas.

outputstring

O formato de saída.

Valores permitidos:jsonphpxml

Respostas

keywordsarray<object>

cpcinteger or null

O Custo por Clique mostra o preço médio que os anunciantes pagam por cada clique em um anúncio nos resultados de pesquisa paga de uma palavra-chave, em centavos de dólar americano (USD).

cpsnumber (float) or null

Cliques por pesquisa (ou CPS) é a proporção de Cliques em relação ao Volume de pesquisa de palavras-chave. Mostra quantos resultados de pesquisa diferentes são clicados, em média, quando as pessoas pesquisam a palavra-chave de destino em um determinado país.

difficultyinteger or null

(10 unidades) Uma estimativa da dificuldade de ranqueamento entre os 10 melhores resultados de busca orgânica para uma palavra-chave em uma escala de 100 pontos.

first_seenstring (date-time) or null

A data em que verificamos pela primeira vez os resultados do mecanismo de pesquisa para uma palavra-chave.

global_volumeinteger or null

(10 unidades) Quantas vezes por mês, em média, as pessoas procuram pela palavra-chave alvo em todos os países no nosso banco de dados.

intentsobject or null

(10 unidades) Indica o objetivo por trás da consulta de pesquisa do usuário. Campos do objeto: informational, navigational, commercial, transactional, branded ou local. Todos os campos são do tipo bool, com valores possíveis true ou false.

keywordstring

parent_topicstring or null

O Tópico principal determina se você consegue ranquear para sua palavra-chave alvo enquanto, em vez disso, visa um tópico mais geral na sua página. Para identificar o Tópico principal, usamos a página ranqueada em primeiro lugar para sua palavra-chave e encontramos a palavra-chave responsável por enviar mais tráfego para essa página.

serp_featuresarray<string>

Os resultados enriquecidos em uma página de resultados do mecanismo de busca (SERP) que não são os resultados orgânicos tradicionais.

Allowed values:ai_overview_sitelinksnippetai_overviewlocal_packsitelinknewsimagevideodiscussiontweetpaid_toppaid_bottompaid_sitelinkshoppingknowledge_cardknowledge_panelquestionimage_thvideo_thorganic_shopping

serp_last_updatestring (date-time) or null

A data da última análise dos resultados de pesquisa para uma palavra-chave.

traffic_potentialinteger or null

(10 unidades) A soma do Tráfego orgânico que a página em 1º lugar para a sua palavra-chave alvo recebe de todas as palavras-chave para as quais ela ranqueia.

volumeinteger or null

(10 unidades) Uma estimativa do número médio de pesquisas mensais de uma palavra-chave ao longo dos últimos 12 meses de dados conhecidos.

volume_desktop_pctnumber (float) or null

A porcentagem de buscas por uma palavra-chave realizadas em computadores.

volume_mobile_pctnumber (float) or null

A porcentagem de buscas por uma palavra-chave realizadas em dispositivos móveis.

volume_monthlyinteger or null

(10 unidades) Uma estimativa do número de buscas por uma palavra-chave no último mês. Este campo pode não ser incluído no parâmetro order_by