Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Qual é a diferença entre 'phrase_all' e 'phrase_this' na API de visão geral de palavras-chave


Qual é a diferença entre 'phrase_all' e 'phrase_this' na API de visão geral de palavras-chave


Com base nos resultados da pesquisa, a principal diferença entre os pontos de extremidade da API `phrase_all` e `phrase_this` para o relatório Visão geral de palavras-chave é:

1. frase_tudo:
- Este endpoint recupera os dados de visão geral de palavras-chave para uma determinada palavra-chave em todos os bancos de dados regionais disponíveis.
- Retorna as métricas de palavras-chave (volume de pesquisa, CPC, concorrência, etc.) agregadas em todos os bancos de dados.
- Isso é útil quando você deseja obter uma visão global do desempenho da palavra-chave.

2. frase_isto:
- Este endpoint recupera os dados de visão geral de palavras-chave para uma determinada palavra-chave, mas para um banco de dados regional específico.
- Você precisa especificar o parâmetro `database` para indicar para qual banco de dados regional você deseja os dados (por exemplo, `database=us`).
- Isso permite que você obtenha dados mais granulares e específicos da região para a palavra-chave.

Resumindo:

- `phrase_all` fornece dados de visão geral de palavras-chave agregados em todas as regiões.
- `phrase_this` permite recuperar a visão geral de palavras-chave para um banco de dados regional específico.

A escolha entre os dois depende se você precisa de uma visão global ou mais localizada dos dados de palavras-chave. Se você estiver almejando um mercado específico, usar o endpoint `phrase_this` com o banco de dados regional apropriado seria mais relevante. Se você deseja uma perspectiva geral e inter-regional, o endpoint `phrase_all` seria mais adequado.

Ambos os endpoints suportam parâmetros adicionais como `display_limit` e `export_columns` para personalizar os dados retornados na resposta.

Citações:
[1] https://www.semrush.com/kb/257-keyword-overview
[2] https://www.semrush.com/kb/972-api-reports
[3] https://developer.semrush.com/api/v3/analytics/keyword-reports/
[4] https://www.semrush.com/features/keyword-research/
[5] https://www.semrush.com/analytics/keywordoverview/