Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon В чем разница между «phrase_all» и «phrase_this» в API обзора ключевых слов


В чем разница между «phrase_all» и «phrase_this» в API обзора ключевых слов


Основываясь на результатах поиска, основное различие между конечными точками API `phrase_all` и `phrase_this` для отчета "Обзор ключевых слов" заключается в следующем:

1. phrase_all:
– Эта конечная точка получает данные обзора ключевых слов для данного ключевого слова во всех доступных региональных базах данных.
- Он возвращает показатели ключевых слов (объем поиска, цена за клик, конкуренция и т. д.), агрегированные по всем базам данных.
– Это полезно, если вы хотите получить глобальное представление об эффективности ключевого слова.

2. phrase_this:
– Эта конечная точка получает данные обзора ключевых слов для данного ключевого слова, но для конкретной региональной базы данных.
– Вам необходимо указать параметр `database`, чтобы указать, для какой региональной базы данных вы хотите получить данные (например, `database=us`).
– Это позволяет получить более подробные данные по ключевому слову, специфичные для региона.

В итоге:

– `phrase_all` предоставляет вам данные обзора ключевых слов, агрегированные по всем регионам.
- `phrase_this` позволяет вам получить обзор ключевых слов для конкретной региональной базы данных.

Выбор между ними зависит от того, нужно ли вам глобальное или более локализованное представление данных ключевых слов. Если вы ориентируетесь на конкретный рынок, использование конечной точки `phrase_this` с соответствующей региональной базой данных будет более уместным. Если вам нужна общая межрегиональная перспектива, конечная точка «phrase_all» будет более подходящей.

Обе конечные точки поддерживают дополнительные параметры, такие как display_limit иexport_columns, для настройки данных, возвращаемых в ответе.

Цитаты:
[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/