Visão geral
API + MCPO filtro regex tem funcionalidade limitada quando usado nesta solicitação, e a sintaxe difere de outras solicitações. Ele espera um símbolo de asterisco (*) como curinga.
Parâmetros de consulta
Um tempo limite manual em segundos.
O número de resultados a retornar.
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.
A expressão de filtro. Os seguintes identificadores de coluna são reconhecidos (isso difere dos identificadores reconhecidos pelo parâmetro select).
clicks: O número médio mensal de Cliques nos resultados de pesquisa realizados pelas pessoas enquanto pesquisam a palavra-chave de destino.
type: integer nullable
cpc: Custo por clique mostra o preço médio que os anunciantes pagam por cada clique em anúncio nos resultados de pesquisa paga para uma palavra-chave, em centavos de USD.
type: integer nullable
cps: Cliques por pesquisa (ou CPS) é a proporção de Cliques em relação ao Volume de pesquisa de palavras-chave. Ele 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.
type: float nullable
difficulty (10 units): Uma estimativa de quão difícil é ranquear entre os 10 primeiros resultados orgânicos de pesquisa para uma palavra-chave em uma escala de 100 pontos.
type: integer nullable
first_seen: A data em que verificamos pela primeira vez os resultados do mecanismo de pesquisa para uma palavra-chave.
type: datetime nullable
global_volume (10 units): Quantas vezes por mês, em média, as pessoas pesquisam a palavra-chave de destino em todos os países do nosso banco de dados.
type: integer nullable
intents (10 units): 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.
type: object nullable
keyword:
type: string
parent_topic: Tópico principal determina se você consegue ranquear para a palavra-chave de destino ao direcionar um tópico mais geral na sua página. Para identificar o Tópico principal, pegamos a página com ranking #1 para a sua palavra-chave e encontramos a palavra-chave responsável por enviar mais tráfego para essa página.
type: string nullable
parent_volume (10 units): O Volume de pesquisa do tópico principal.
type: integer nullable
serp_domain_rating_top10_min: A palavra-chave deve ter pelo menos uma posição de ranking nos 10 primeiros resultados com um DR até este valor.
type: float nullable
serp_domain_rating_top5_min: A palavra-chave deve ter pelo menos uma posição de ranking nos 5 primeiros resultados com um DR até este valor.
type: float nullable
serp_features: Os resultados enriquecidos em uma página de resultados do mecanismo de pesquisa (SERP) que não são resultados orgânicos tradicionais.
type: array(string)
enum: "ai_overview_sitelink" "snippet" "ai_overview" "local_pack" "sitelink" "news" "image" "video" "discussion" "tweet" "paid_top" "paid_bottom" "paid_sitelink" "shopping" "knowledge_card" "knowledge_panel" "question" "image_th" "video_th" "organic_shopping"
serp_last_update: A data da última análise dos resultados do mecanismo de pesquisa para uma palavra-chave.
type: datetime nullable
traffic_potential (10 units): A soma do Tráfego orgânico que a página com ranking #1 para a palavra-chave de destino recebe de todas as palavras-chave para as quais ela ranqueia.
type: integer nullable
volume (10 units): Uma estimativa do número médio mensal de pesquisas por uma palavra-chave ao longo dos últimos 12 meses de dados conhecidos.
type: integer nullable
volume_desktop_pct: A porcentagem de pesquisas por uma palavra-chave realizadas em dispositivos desktop.
type: float nullable
volume_mobile_pct: A porcentagem de pesquisas por uma palavra-chave realizadas em dispositivos móveis.
type: float nullable
word_count:
type: integer
Uma lista de colunas separadas por vírgula para retornar. Consulte o Schema de resposta para ver os identificadores de coluna válidos.
A data final no formato AAAA-MM-DD para recuperar volumes históricos mensais de Volume de pesquisa no campo volume_monthly_history. Obrigatória apenas se volume_monthly_history for solicitado.
A data inicial no formato AAAA-MM-DD para recuperar volumes históricos mensais de Volume de pesquisa no campo volume_monthly_history. Obrigatória apenas se volume_monthly_history for solicitado.
O escopo do URL de destino que você especificou.
O alvo da pesquisa: um domínio ou uma URL.
Filtra palavras-chave com base na posição de ranking do target especificado.
Um código de país com duas letras (ISO 3166-1 alpha-2).
[Descontinuado em 5 de ago. de 2024].
Uma lista de palavras-chave separadas por vírgula para exibir métricas.
O ID de uma lista de palavras-chave existente para exibir métricas.
O formato de saída.
Respostas
O número médio mensal de Cliques nos resultados de pesquisa realizados pelas pessoas enquanto pesquisam a palavra-chave de destino.
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).
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.
(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.
A data em que verificamos pela primeira vez os resultados do mecanismo de pesquisa para uma palavra-chave.
(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.
(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.
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.
(10 unidades) O volume de pesquisa do tópico principal.
A porcentagem média mensal de pessoas que clicaram tanto em resultados orgânicos quanto em resultados pagos ao pesquisar pela palavra-chave alvo.
A porcentagem média mensal de pessoas que clicaram apenas em resultados orgânicos ao pesquisar pela palavra-chave alvo.
A porcentagem média mensal de pessoas que clicaram apenas em resultados pagos ao pesquisar pela palavra-chave alvo.
Os resultados enriquecidos em uma página de resultados do mecanismo de busca (SERP) que não são os resultados orgânicos tradicionais.
A data da última análise dos resultados de pesquisa para uma palavra-chave.
(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.
(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.
A porcentagem de buscas por uma palavra-chave realizadas em computadores.
A porcentagem de buscas por uma palavra-chave realizadas em dispositivos móveis.
(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
(2 unidades por mês histórico, com um mínimo de 50 unidades) Estimativas históricas mensais do Volume de pesquisa de uma palavra-chave para o período definido pelos parâmetros volume_monthly_date_from e volume_monthly_date_to.