API Ranktracker вже працює — доступ до нього включено в кожен тарифний план

Вступ

API Ranktracker офіційно запущено.

Тепер кожен тарифний план Ranktracker включає доступ до API, що дає клієнтам можливість безпосередньо інтегрувати Ranktracker зі своїми інформаційними панелями, платформами для створення звітів, внутрішніми системами та робочими процесами з SEO.

Вам більше не потрібна окрема підписка на API або обліковий запис лише для підприємств, щоб розпочати роботу. Незалежно від того, чи використовуєте ви тарифні плани «Launch», «Growth», «Scale» чи «Authority», ви можете створити ключ API та працювати програмно з даними, доступними у вашому обліковому записі Ranktracker.

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

Ознайомтеся з повною документацією для розробників за адресою developers.ranktracker.com.

Чому ми створили API Ranktracker

Командам SEO дедалі частіше потрібні дані про позиції в пошуку поза межами однієї платформи.

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

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

API Ranktracker вирішує цю проблему, дозволяючи вашим системам безпосередньо взаємодіяти з Ranktracker.

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

Доступ до API включено в кожен тарифний план Ranktracker

Доступ до API не обмежується лише нашим найбільшим тарифним планом.

Він включений у:

• Запуск
• «Зростання»
• Scale
• Авторитет

Ваша активність через API здійснюється в межах лімітів на ключові слова, рядки даних, конкурентів та інших обмежень, пов’язаних із вашою підпискою.

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

Це дає кожному клієнту можливість експериментувати з автоматизацією, незалежно від розміру компанії чи технічних ресурсів.

Малі підприємства можуть підключити Ranktracker до простої внутрішньої інформаційної панелі. Агентства можуть автоматизувати підключення клієнтів та формування звітів. Більші команди можуть побудувати повні конвеєри даних навколо свого облікового запису Ranktracker.

Повні дані про рейтинг у топ-100

Ranktracker побудований на основі повного відстеження топ-100.

Замість того, щоб зупинятися на першій сторінці Google, Ranktracker відстежує всі десять сторінок органічних результатів. Це допомагає вам виявляти ключові слова, які починають набирати видимість ще до того, як потраплять на першу сторінку.

За допомогою API ви можете отримати останню історію позицій, пов’язану з відстежуваним ключовим словом, включаючи таку інформацію, як:

• Поточна позиція в органічних результатах
• Абсолютна позиція в SERP
• URL рейтингу
• Щоденні зміни рейтингу
• Тижнева зміна позиції
• Щомісячна динаміка рейтингу
• Обсяг пошукових запитів
• Орієнтовний трафік
• Вартість за клік
• Конкуренція
• Складність ключового слова

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

Відстеження у понад 107 000 місцевостей

Ranktracker підтримує понад 107 000 локацій для відстеження, а також відстеження на настільних комп’ютерах і мобільних пристроях та широке мовне покриття. Це робить API придатним для:

• Місцеві SEO-кампанії
• Моніторинг пошуку на національному рівні
• Міжнародне SEO
• Багатомовні веб-сайти
• Франшизи та підприємства з декількома філіями
• Агентства, що обслуговують клієнтів на різних ринках

Ключове слово можна відстежувати за різними комбінаціями місцезнаходження, мови та пристрою.

Наприклад, агентство може відстежувати одне й те саме ключове слово на настільних комп’ютерах та мобільних пристроях у Лондоні, Манчестері та Бірмінгемі. Кожна комбінація зберігається як окремий рядок відстеження, що дає агентству більш точне уявлення про те, як ефективність пошуку відрізняється залежно від ринку.

Що можна робити за допомогою API Ranktracker

API надає доступ до основних ресурсів, що використовуються в обліковому записі Ranktracker.

Управління доменами

Ви можете програмно створювати, отримувати, оновлювати та видаляти відстежувані домени.

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

Кінцеві точки на рівні домену також надають дані про історію позицій у рейтингу та частку голосу за вибраний період. Запити щодо історії та частки голосу можуть охоплювати періоди до 365 днів і фільтруватися за настільними, мобільними або всіма пристроями. Управління конкурентами

Додавайте, переглядайте, оновлюйте або видаляйте конкурентів, пов’язаних із кожним відстежуваним доменом.

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

Додавання та управління ключовими словами

Створюйте ключові слова для відстеження домену та вказуйте пошукову систему, місцезнаходження, мову, пристрій та частоту відстеження.

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

Отримання історії позицій

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

Ці дані можна надіслати до:

• Портали звітності для клієнтів
• Таблиці Google
• Склади даних
• Панелі бізнес-аналітики
• Внутрішні системи сповіщень
• Індивідуальні SEO-додатки

Документація містить повний посібник з вилучення щоденних позицій у рейтингу та завантаження їх у сховище даних або робочий процес на основі CSV-файлів. Отримати доступ до результатів SERP

Кожне відстежуване ключове слово надає доступ до своїх останніх проаналізованих результатів пошуку.

Сюди входять органічні результати та функції SERP, що їх оточують. Ranktracker відстежує такі функції, як виділені фрагменти, результати на карті, відео, результати пошуку товарів, результати «Люди також запитують» та огляди на основі штучного інтелекту. Для відстежуваних ключових слів, що підтримуються, також доступний кешований HTML-код SERP. Це означає, що ви можете аналізувати не лише числовий рейтинг домену.

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

Створюйте звіти про частку голосу

Ендпоінт «частка голосу» повертає загальний показник видимості, його зміну за вибраний період та щоденну серію, що порівнює ваш домен із відстежуваними конкурентами.

Ці дані вже структуровані для створення діаграм та звітів. Ви можете використовувати їх для створення тренду видимості, що показує, чи набирає ваш бренд позиції, чи втрачає їх порівняно з конкуруючими доменами. Організуйте ключові слова за допомогою тегів

Створюйте теги на рівні облікового запису та застосовуйте їх до ключових слів у різних проєктах.

Теги можна використовувати для розмежування:

• Брендові та небрендові ключові слова
• Продукти та послуги
• Країни або місцезнаходження
• Кампанії
• Пріоритетні ключові слова
• Групи звітів для клієнтів
• Різні розділи веб-сайту

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

Кінцева точка використання облікового запису показує, яка частина вашого тарифного плану вже використана, а яка — ще залишається.

Він повідомляє про ліміти, включаючи:

• Активні ключові слова
• Рядки даних
• Перевірки на запит
• Кредити SERP Analyser

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

Створено для агентств

Агентства — одна з основних груп, які можуть скористатися новим API.

Типовий автоматизований робочий процес підключення клієнта може:

1. Створіть домен клієнта.
2. Додайте їхніх конкурентів.
3. Імпортуйте цільові ключові слова.
4. Налаштуйте місцезнаходження, мови та пристрої.
5. Створіть теги, специфічні для клієнта.
6. Надішліть дані про позиції в рейтингу на внутрішню інформаційну панель.
7. Створюйте регулярні звіти про видимість.

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

Агентства також можуть завантажувати щоденні знімки рейтингу у власну базу даних і презентувати інформацію на порталі під власним брендом.

Створено для внутрішніх SEO-команд

Внутрішні команди можуть пов’язувати рейтинги з більш широкими бізнес-даними.

Наприклад, ефективність ключових слів можна поєднати з:

• Кліки в Google Search Console
• Конверсії на веб-сайті
• Дохід від електронної комерції
• Генеровані ліди
• Ефективність цільових сторінок
• Дати публікації контенту
• Технічні оновлення SEO

Це дозволяє вийти за межі ізольованих звітів про рейтинги та зрозуміти, як видимість у пошуку впливає на загальні бізнес-результати.

Створено для SEO-платформ та розробників

Розробники можуть використовувати Ranktracker як джерело даних про рейтинги та SERP для внутрішніх інструментів або додатків, орієнтованих на клієнтів.

API дотримується єдиної структури REST, а всі робочі кінцеві точки використовують:

https://api.ranktracker.com/v1

Відповіді надаються у форматі JSON:API. Ресурси повертаються у розділі data, а їхні поля містяться в об’єкті attributes. Кінцеві точки списків підтримують пагінацію до 1 000 записів на сторінку та повертають загальну кількість через заголовки відповіді. Документація наразі містить практичні приклади щодо:

• cURL
• Python
• Node.js

Вона також містить повні посібники, що охоплюють створення доменів, відстеження ключових слів, експорт даних у сховище, звіти про частку голосу та масове тегування ключових слів.

Як створити свій ключ API

Початок роботи займає лише кілька кроків:

1. Увійдіть у свій обліковий запис Ranktracker.
2. Відкрийте налаштування облікового запису.
3. Перейдіть до розділу «Ключі API».
4. Створіть новий ключ API.
5. Збережіть ключ у безпечному місці на своєму сервері.

Ключі API мають такий формат:

tkn_usr_...

Ваш ключ слід передавати безпосередньо в заголовку «Authorization ». Префікс «Bearer» не потрібен. Нижче наведено приклад базового запиту, який відображає список доменів у вашому обліковому записі:

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

До ключів API завжди слід ставитися як до паролів. Їх не слід розміщувати у відкритих репозиторіях, коді браузера чи мобільних додатках.

Розроблено для надійної автоматизації

API використовує стандартні методи HTTP та передбачувані структури відповідей.

Він підтримує:

• GET для отримання ресурсів
• POST — для створення ресурсів
• PATCH — для оновлення ресурсів
• DELETE для видалення ресурсів

Помилки містять машиночитані коди та описи, завдяки чому інтеграції можуть визначити, чи потрібно виправити запит, чи обліковий запис досяг свого ліміту або чи слід повторити тимчасовий запит. Операції k, пагінація та звіти про використання також допомагають зменшити кількість непотрібних запитів під час управління великими проєктами.

Коротка інформація про MCP

Ranktracker також пропонує опцію сервера MCP для підключення підтримуваних інструментів штучного інтелекту та асистентів до даних Ranktracker.

Про сервер MCP, сумісні інструменти та процес підключення ми розповімо в окремій статті.

Почніть роботу з API Ranktracker

API Ranktracker надає фахівцям з SEO більше контролю над тим, як вони збирають, упорядковують та використовують свої пошукові дані.

Ви можете автоматизувати робочі процеси відстеження позицій, синхронізувати проекти, отримувати повні результати Топ-100, аналізувати особливості SERP, порівнювати частку голосу та інтегрувати SEO-дані в системи, якими вже користується ваша організація.

Найголовніше — доступ до API тепер включено в кожен тарифний план Ranktracker.

Створіть свій ключ API у своєму обліковому записі Ranktracker та ознайомтеся з документацією за адресою developers.ranktracker.com.