Сторінки конкурентів

API + MCP

GET/v3/rank-tracker/competitors-pages

Запити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць 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.

target_and_tracked_competitors_onlyboolean

Обмежити сторінки цільовим брендом і відстежуваними конкурентами

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

outputstring

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

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

Відповіді

competitors-pagesarray<object>

keywordsinteger

Загальна кількість ключових слів, за якими ваша ціль займає перші 100 позицій в результатах органічного пошуку.

share_of_traffic_valuenumber (float)

Частка вартості органічного пошукового трафіку цільового ресурсу, як порівняти з загальною вартістю органічного пошукового трафіку за всіма відстежуваними ключовими словами.

share_of_traffic_value_prevnumber (float)

Частка цінності трафіку на дату порівняння.

share_of_voicenumber (float)

Частка органічного пошукового трафіку цільового вебсайту, як порівняти з загальним органічним пошуковим трафіком за всіма відстежуваними ключовими словами.

share_of_voice_prevnumber (float)

Частка голосу на дату порівняння.

statusstring

Статус сторінки: нова сторінка, що щойно почала ранжуватися («left»), втрачена сторінка, що зникла з результатів пошуку («right»), або без змін («both»).

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

titlestring or null

Заголовок, що відображається для сторінки в SERP її основного ключового слова.

title_prevstring or null

Заголовок на дату порівняння.

trafficinteger

Приблизна кількість щомісячних відвідувань, які ваша сторінка отримує з органічного пошуку.

traffic_previnteger

Трафік на дату порівняння.

traffic_valueinteger or null

Приблизна вартість щомісячного органічного пошукового трафіку сторінки, у центах USD.

traffic_value_previnteger or null

Цінність трафіку на дату порівняння.

urlstring (url)

URL сторінки.