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

API + MCP

GET/v3/rank-tracker/competitors-overview

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

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

timeoutinteger

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

limitinteger

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

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

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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

date_comparedstring (date)

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

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

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

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

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

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

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

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

volume_modestring

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

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

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

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).

Allowed values:ADAEAFAGAIALAMAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMOTHERPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZW

keywordstring

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

keyword_difficultyinteger or null

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

keyword_has_databoolean

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

keyword_is_frozenboolean

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

languagestring

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

locationstring

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

serp_featuresarray<string>

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

Allowed values:paid_toppaid_bottompaid_rightpaid_sitelinkorganicsitelinksnippetimagearticleknowledge_cardknowledge_panellocal_packlocal_teasernewsquestionreviewshoppingtweetspellingvideodiscussionai_overviewai_overview_sitelinkorganic_shoppingimage_thvideo_thai_overview_found

serp_updatedstring (date-time) or null

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

serp_updated_prevstring (date-time) or null

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

tagsarray<string>

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

volumeinteger or null

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