Огляд
API + MCPЗапити до цього ендпоїнта безкоштовні та не витрачають жодних одиниць API.
Параметри запиту
Тривалість таймауту в секундах, задана вручну.
Кількість результатів, які потрібно повернути.
Список стовпців, розділених комами, за якими слід упорядкувати результати, з необов'язковим напрямком. Див. схему відповіді для дійсних ідентифікаторів стовпців.
Вираз фільтра. Розпізнаються такі ідентифікатори колонок (вони відрізняються від ідентифікаторів, які розпізнає параметр select).
best_position_has_thumbnail: Найвища позиція (або цільова URL-адреса, якщо задано) має мініатюру.
тип: boolean nullable
best_position_has_thumbnail_previous: Найвища позиція (або цільова URL-адреса, якщо задано) має мініатюру на дату порівняння.
тип: boolean nullable
best_position_has_video_preview: Найвища позиція (або цільова URL-адреса, якщо задано) має попередній перегляд відео.
тип: boolean nullable
best_position_has_video_preview_previous: Найвища позиція (або цільова URL-адреса, якщо задано) має попередній перегляд відео на дату порівняння.
тип: boolean nullable
best_position_kind: Тип найвищої позиції (або цільової URL-адреси, якщо задано): органічна, платна або «Функції SERP».
тип: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
best_position_kind_previous: Тип найвищої позиції (або цільової URL-адреси, якщо задано) на дату порівняння.
тип: string nullable
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping"
clicks: Показник «Кліки» — це середня щомісячна кількість кліків у результатах пошуку, які люди здійснюють, шукаючи цільове ключове слово. Деякі пошуки дають кліки по кількох результатах, а інші можуть узагалі не завершитися жодним кліком.
тип: integer nullable
clicks_per_search: «Кількість кліків на пошук» — це співвідношення «Кліки» до «Обсяг пошуку» ключового слова. Воно показує, скільки різних результатів пошуку в середньому отримують кліки, коли люди шукають цільове ключове слово в певній країні.
тип: float nullable
cost_per_click: «Ціна за клік» показує середню ціну, яку рекламодавці сплачують за кожен клік по оголошенню в платній видачі для ключового слова.
тип: integer nullable
country: Країна, у якій відстежується певне ключове слово. Дволітерний код країни (ISO 3166-1 alpha-2).
тип: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
country_prev: Країна, у якій відстежувалося певне ключове слово на дату порівняння. Дволітерний код країни (ISO 3166-1 alpha-2).
тип: string
enum: "AD" "AE" "AF" "AG" "AI" "AL" "AM" "AO" "AQ" "AR" "AS" "AT" "AU" "AW" "AX" "AZ" "BA" "BB" "BD" "BE" "BF" "BG" "BH" "BI" "BJ" "BL" "BM" "BN" "BO" "BQ" "BR" "BS" "BT" "BV" "BW" "BY" "BZ" "CA" "CC" "CD" "CF" "CG" "CH" "CI" "CK" "CL" "CM" "CN" "CO" "CR" "CU" "CV" "CW" "CX" "CY" "CZ" "DE" "DJ" "DK" "DM" "DO" "DZ" "EC" "EE" "EG" "EH" "ER" "ES" "ET" "FI" "FJ" "FK" "FM" "FO" "FR" "GA" "GB" "GD" "GE" "GF" "GG" "GH" "GI" "GL" "GM" "GN" "GP" "GQ" "GR" "GS" "GT" "GU" "GW" "GY" "HK" "HM" "HN" "HR" "HT" "HU" "ID" "IE" "IL" "IM" "IN" "IO" "IQ" "IR" "IS" "IT" "JE" "JM" "JO" "JP" "KE" "KG" "KH" "KI" "KM" "KN" "KP" "KR" "KW" "KY" "KZ" "LA" "LB" "LC" "LI" "LK" "LR" "LS" "LT" "LU" "LV" "LY" "MA" "MC" "MD" "ME" "MF" "MG" "MH" "MK" "ML" "MM" "MN" "MO" "MP" "MQ" "MR" "MS" "MT" "MU" "MV" "MW" "MX" "MY" "MZ" "NA" "NC" "NE" "NF" "NG" "NI" "NL" "NO" "NP" "NR" "NU" "NZ" "OM" "OTHER" "PA" "PE" "PF" "PG" "PH" "PK" "PL" "PM" "PN" "PR" "PS" "PT" "PW" "PY" "QA" "RE" "RO" "RS" "RU" "RW" "SA" "SB" "SC" "SD" "SE" "SG" "SH" "SI" "SJ" "SK" "SL" "SM" "SN" "SO" "SR" "SS" "ST" "SV" "SX" "SY" "SZ" "TC" "TD" "TF" "TG" "TH" "TJ" "TK" "TL" "TM" "TN" "TO" "TR" "TT" "TV" "TW" "TZ" "UA" "UG" "UM" "US" "UY" "UZ" "VA" "VC" "VE" "VG" "VI" "VN" "VU" "WF" "WS" "YE" "YT" "ZA" "ZM" "ZW"
created_at: Дата, коли ключове слово було додано в «Проєкт».
тип: datetime
is_branded: Намір користувача: брендований. Користувач шукає конкретний бренд або назву компанії.
тип: boolean
is_commercial: Намір користувача: комерційний. Користувач порівнює товари або послуги перед ухваленням рішення про покупку.
тип: boolean
is_informational: Намір користувача: інформаційний. Користувач шукає інформацію або відповідь на конкретне запитання.
тип: boolean
is_local: Намір користувача: локальний. Користувач шукає інформацію, релевантну конкретній локації, або послуги поруч.
тип: boolean
is_main_position: Виключає позиції з блоку «Огляди від ШІ», «Sitelinks», «Top stories», «Image packs», «Videos», «Discussions and forums» і пости в X (Twitter).
тип: boolean
is_main_position_prev: Виключає позиції з блоку «Огляди від ШІ», «Sitelinks», «Top stories», «Image packs», «Videos», «Discussions and forums» і пости в X (Twitter) на дату порівняння.
тип: boolean
is_navigational: Намір користувача: навігаційний. Користувач шукає конкретний сайт або вебсторінку.
тип: boolean
is_transactional: Намір користувача: транзакційний. Користувач готовий виконати дію, часто — покупку.
тип: boolean
keyword: Ключове слово, за яким ранжується ваша ціль.
тип: string
keyword_difficulty: Оцінка того, наскільки складно потрапити в топ-10 органічних результатів пошуку за ключовим словом за шкалою 0–100.
тип: integer nullable
keyword_has_data: Поверне false, якщо ключове слово ще обробляється і SERP ще не було отримано.
тип: boolean
keyword_is_frozen: Показує, чи перевищило ключове слово ліміт відстежуваних ключових слів у вашому плані. Такі ключові слова «заморожуються», тобто їхні позиції не оновлюються.
тип: boolean
keyword_prev: Ключове слово, за яким ранжувалася ваша ціль на дату порівняння.
тип: string
keyword_words: Кількість слів у ключовому слові.
тип: integer
keyword_words_prev: Кількість слів у ключовому слові на дату порівняння.
тип: integer
language: Мова SERP, для якої відстежується певне ключове слово.
тип: string
language_prev: Мова SERP на дату порівняння.
тип: string
location: Локація (країна, штат/область або місто), у якій відстежується певне ключове слово.
тип: string
location_prev: Локація (країна, штат/область або місто), у якій відстежувалося певне ключове слово на дату порівняння.
тип: string
parent_topic: «Основна тема» визначає, чи можете ви ранжуватися за цільовим ключовим словом, натомість таргетуючи на сторінці ширшу тему. Щоб визначити «Основна тема», ми беремо сторінку, що займає позицію #1 за вашим ключовим словом, і знаходимо ключове слово, яке приносить на цю сторінку найбільше трафіку.
тип: string nullable
position: Найвища позиція (або цільова URL-адреса, якщо задано) в органічному пошуку.
тип: integer nullable
position_diff: Зміна найвищої позиції (або цільової URL-адреси, якщо задано) між вибраними датами.
тип: integer nullable
position_prev: Найвища позиція (або цільова URL-адреса, якщо задано) на дату порівняння.
тип: integer nullable
search_type_image: Тип пошуку Image показує відсоток пошуків за ключовим словом, виконаних для зображень, підкреслюючи інтерес до візуального контенту.
тип: float nullable
search_type_news: Тип пошуку News показує відсоток пошуків за ключовим словом, виконаних для новинних статей.
тип: float nullable
search_type_video: Тип пошуку Video показує відсоток пошуків за ключовим словом, виконаних для відео, відображаючи інтерес до відеоконтенту.
тип: float nullable
search_type_web: Тип пошуку Web показує відсоток пошуків за ключовим словом, виконаних для загального вебконтенту, що вказує на інтерес до широкого спектра інформації.
тип: float nullable
serp_features: «Функції SERP», які з'являються в результатах пошуку за ключовим словом.
тип: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_features_prev: «Функції SERP», які з'являються в результатах пошуку за ключовим словом на дату порівняння.
тип: array(string)
enum: "paid_top" "paid_bottom" "paid_right" "paid_sitelink" "organic" "sitelink" "snippet" "image" "article" "knowledge_card" "knowledge_panel" "local_pack" "local_teaser" "news" "question" "review" "shopping" "tweet" "spelling" "video" "discussion" "ai_overview" "ai_overview_sitelink" "organic_shopping" "image_th" "video_th" "ai_overview_found"
serp_updated: Дата, коли ми востаннє перевіряли результати пошуку за ключовим словом.
тип: datetime nullable
serp_updated_prev: Дата, коли ми перевіряли результати пошуку станом на дату порівняння.
тип: datetime nullable
tags: Список тегів, призначених певному ключовому слову.
тип: array(string)
tags_prev: Список тегів, призначених певному ключовому слову на дату порівняння.
тип: array(string)
target_positions_count: Кількість цільових URL-адрес, які ранжуються за ключовим словом.
тип: integer
traffic: Оцінка кількості щомісячних відвідувань, які сторінка отримує з органічного пошуку за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".
тип: integer nullable
traffic_diff: Зміна трафіку між вибраними датами.
тип: integer nullable
traffic_prev: Оцінка кількості щомісячних відвідувань, які сторінка отримує з органічного пошуку за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".
тип: integer nullable
url: URL-адреса з найвищим ранжуванням (або цільова URL-адреса, якщо задано) в органічному пошуку.
тип: string nullable
url_prev: URL-адреса з найвищим ранжуванням (або цільова URL-адреса, якщо задано) на дату порівняння.
тип: string nullable
volume: Оцінка середньої щомісячної кількості пошуків за ключовим словом за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".
тип: integer nullable
volume_desktop_pct: Відсоток загального «Обсяг пошуку», що припадає на десктопні пристрої.
тип: float nullable
volume_mobile_pct: Відсоток загального «Обсяг пошуку», що припадає на мобільні пристрої.
тип: float nullable
Список стовпців, розділених комами, які потрібно повернути. Див. Schema відповіді для коректних ідентифікаторів стовпців.
Дата для порівняння метрик у форматі YYYY-MM-DD.
Дата, станом на яку потрібні метрики, у форматі YYYY-MM-DD.
Виберіть позиції для мобільних або десктопних пристроїв.
Унікальний ідентифікатор проєкту. Його можна знайти в URL вашого проєкту Rank Tracker в Ahrefs: https://app.ahrefs.com/rank-tracker/overview/#project_id#
Режим обчислення обсягу пошуку: щомісячний або середній. Він впливає на обсяг, трафік і цінність трафіку.
Формат виводу.
Відповіді
Найвища позиція (або цільова URL-адреса, якщо задано) має мініатюру.
Найвища позиція (або цільова URL-адреса, якщо задано) має мініатюру на дату порівняння.
Найвища позиція (або цільова URL-адреса, якщо задано) має попередній перегляд відео.
Найвища позиція (або цільова URL-адреса, якщо задано) має попередній перегляд відео на дату порівняння.
Тип найвищої позиції (або цільової URL-адреси, якщо задано): органічна, платна або «Функції SERP».
Тип найвищої позиції (або цільових URL-адрес, якщо задано) на дату порівняння.
Показник «Кліки» означає середню місячну кількість кліків за результатами пошуку, які люди здійснюють під час пошуку за цільовим ключовим словом. Деякі пошукові запити генерують кліки одразу за кількома результатами, тоді як інші можуть не призвести до жодного кліку.
Кількість кліків на пошук – це співвідношення кліків до частоти пошуку за ключовими словами. Показує, скільки в середньому різних результатів пошуку отримують кліки, коли люди здійснюють пошук за цільовим ключовим словом у певній країні.
Ціна за клік показує середню ціну, яку рекламодавці платять за кожен клік по рекламі в платних результатах пошуку за ключовим словом.
Країна, у якій відстежується задане ключове слово. Дволітерний код країни (ISO 3166-1 alpha-2).
Країна, у якій відстежувалося задане ключове слово на дату порівняння. Дволітерний код країни (ISO 3166-1 alpha-2).
Дата додавання ключового слова до проєкту.
Намір користувача: брендовий. Користувач шукає конкретний бренд або назву компанії.
Намір користувача: комерційний. Користувач порівнює товари чи послуги перед прийняттям рішення про покупку.
Намір користувача: інформаційний. Користувач шукає інформацію або відповідь на конкретне запитання.
Намір користувача: локальний. Користувач шукає інформацію, пов'язану з конкретною місцевістю або послугами поблизу.
Намір користувача: навігаційний. Користувач шукає конкретний вебсайт або сторінку.
Намір користувача: транзакційний. Користувач готовий виконати дію, зазвичай покупку.
Ключове слово, за яким ранжується ваш цільовий ресурс.
Оцінка складності потрапляння в топ-10 органічної видачі за ключовим словом за 100-бальною шкалою.
Поверне false, якщо ключове слово все ще обробляється і SERP ще не було отримано.
Показує, чи перевищило ключове слово ліміт відстежуваних ключових слів у вашому тарифному плані. Такі ключові слова «заморожені», тобто їхні позиції не оновлюються.
Ключове слово, за яким ранжується ваш цільовий ресурс, на дату порівняння.
Мова SERP, за якою відстежується задане ключове слово.
Мова SERP на дату порівняння.
Місце розташування (країна, штат/провінція або місто), де відстежується дане ключове слово.
Місце розташування (країна, штат/провінція або місто), де відстежувалося дане ключове слово на дату порівняння.
Основна тема визначає, чи можете ви ранжуватися за цільовим ключовим словом, одночасно орієнтуючись на більш загальну тему на вашій сторінці. Щоб визначити основну тему, ми беремо сторінку №1 у рейтингу за вашим ключовим словом і знаходимо ключове слово, що відповідає за найбільший трафік на цій сторінці.
Найвища позиція (або цільових URL-адрес, якщо задано) в органічному пошуку.
Зміна найвищої позиції (або цільових URL-адрес, якщо задано) між вибраними датами.
Найвища позиція (або цільових URL-адрес, якщо задано) на дату порівняння.
Тип пошуку «Зображення» показує відсоток пошукових запитів за ключовими словами для зображень, що підкреслює інтерес до візуального контенту.
Тип пошуку «Новини» показує відсоток пошукових запитів за ключовим словом для статей новин.
Тип пошуку «Відео» показує відсоток пошукових запитів за ключовим словом для відео, що демонструє інтерес до відеоконтенту.
Тип пошуку Web показує відсоток пошукових запитів за ключовим словом, виконаних щодо загального вебконтенту, що вказує на інтерес до широкого спектра інформації.
Функції SERP, що з'являються в результатах пошуку за ключовим словом.
Функції SERP, що з'являються в результатах пошуку за ключовим словом станом на дату порівняння.
Дата, коли ми востаннє перевіряли результати з пошукової системи за ключовим словом.
Дата, коли ми перевірили результати пошукової системи станом на дату порівняння.
Список тегів, призначених для вказаного ключового слова.
Список тегів, призначених певному ключовому слову на дату порівняння.
Кількість цільових URL-адрес, що ранжуються за ключовим словом.
Оцінка кількості щомісячних візитів, які сторінка отримує з органічного пошуку за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".
Зміна в трафіку між вашими вибраними датами.
Оцінка кількості щомісячних візитів, які сторінка отримує з органічного пошуку за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".
URL, що займає найвищу позицію (або цільовий URL, якщо задано) в органічному пошуку.
URL, що займає найвищу позицію (або цільовий URL, якщо задано) на дату порівняння.
Оцінка середньої щомісячної кількості пошукових запитів за ключовим словом за останній місяць або за останні відомі 12 місяців даних — залежно від параметра "volume_mode".
Відсоток загального обсягу пошуку, що припадає на десктопні пристрої.
Відсоток загального обсягу пошуку, що припадає на мобільні пристрої.