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

API + MCP

GET/v3/rank-tracker/competitors-pages

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

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

timeoutinteger

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

limitinteger

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

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

order_bystring

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

Example:field_a,field_b:asc,field_c:desc

wherestring

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

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

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

target_and_tracked_competitors_onlyboolean

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

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

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

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

Дозволені значення: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»).

Allowed values: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 сторінки.