Огляд конкурентів

API + MCP

GET/v3/rank-tracker/competitors-overview

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.

Параметри запиту

selectstringОбов’язково

Список стовпців для повернення, розділений комами. Див. схему відповіді (Schema) для коректних ідентифікаторів стовпців.

wherestring

Вираз фільтра. Розпізнаються такі ідентифікатори стовпців (вони відрізняються від ідентифікаторів, які розпізнає параметр select).

order_bystring

Список стовпців, розділених комами, за якими слід упорядкувати результати, з необов'язковим напрямком. Див. схему відповіді для дійсних ідентифікаторів стовпців.

Example:field_a,field_b:asc,field_c:desc

limitinteger

Кількість результатів, які потрібно повернути.

За Замовчуванням:1000

timeoutinteger

Тривалість заданого вручну тайм-ауту в секундах.

volume_modestring

Режим розрахунку обсягу пошуку: щомісячний або середній. Він впливає на обсяг, трафік і цінність трафіку.

Дозволені значення:monthlyaverage

За Замовчуванням:monthly

project_idintegerОбов’язково

Унікальний ідентифікатор проєкту. Його можна знайти в URL-адресі вашого проєкту Rank Tracker в Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#

devicestringОбов’язково

Виберіть позиції для мобільних або десктопних пристроїв.

Дозволені значення:desktopmobile

datestring (date)Обов’язково

Дата, за яку потрібно надати показники, у форматі YYYY-MM-DD.

date_comparedstring (date)

Дата для порівняння метрик у форматі YYYY-MM-DD.

outputstring

Формат виводу.

Дозволені значення:jsonphp

Відповіді

keywordsarray<object>

competitors_listarray<object>

Інформація про конкурентів для заданого ключового слова. Включено такі поля: url, url_prev, position, position_prev, best_position_kind, best_position_kind_prev, traffic, traffic_prev, value, value_prev. Поля, що закінчуються на prev, додаються лише у режимі порівняння.

countrystring

Країна, у якій відстежується задане ключове слово. Дволітерний код країни (ISO 3166-1 alpha-2).

Дозволені значення:ADAEAFAGAIALAMAOAQARASATAUAWAX…

keywordstring

Ключове слово, за яким ранжується ваш цільовий ресурс.

keyword_difficultyinteger or null

Оцінка складності потрапляння в топ-10 органічної видачі за ключовим словом за 100-бальною шкалою.

keyword_has_databoolean

Поверне false, якщо ключове слово все ще обробляється і SERP ще не було отримано.

keyword_is_frozenboolean

Показує, чи перевищило ключове слово ліміт відстежуваних ключових слів у вашому тарифному плані. Такі ключові слова «заморожені», тобто їхні позиції не оновлюються.

languagestring

Мова SERP, за якою відстежується задане ключове слово.

locationstring

Місце розташування (країна, штат/провінція або місто), де відстежується дане ключове слово.

serp_featuresarray<string>

Функції SERP, що з'являються в результатах пошуку за ключовим словом.

Дозволені значення:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestion…

serp_updatedstring (date-time) or null

Дата, коли ми востаннє перевіряли результати з пошукової системи за ключовим словом.

serp_updated_prevstring (date-time) or null

Дата, коли ми перевірили результати пошукової системи станом на дату порівняння.

tagsarray<string>

Список тегів, призначених для вказаного ключового слова.

volumeinteger or null

Оцінка середньої щомісячної кількості пошукових запитів за ключовим словом за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".