Перейти до основного контенту

Serpstat API

Serpstat API: програмний доступ до даних по ключових фразах, доменах, зворотних посиланнях і аудиту через JSON-RPC 2.0 для автоматизації SEO-процесів.

Автор: Mike

Програмний доступ до всіх даних Serpstat

Serpstat API надає прямий доступ до всіх даних платформи — метрик доменів, ранжування ключових фраз, профілів зворотних посилань, результатів аудиту сайту та іншого — через REST API у форматі JSON-RPC 2.0. Використовуйте його для автоматизації збору даних, побудови інтеграцій і масштабування SEO-процесів.


Що ви можете зробити:

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

  • Масштабуйте робочі процеси: Запускайте пакетні запити по сотнях доменів або ключових фраз — тариф Agency підтримує до 2 000 000 API-запитів на місяць.

  • Інтегруйтесь зі своїм стеком: Підключайте дані Serpstat до Google Таблиць, Looker Studio, Python-скриптів, R-пакетів або будь-якої системи, що приймає HTTP JSON-відповіді.


Початок роботи

  1. Переконайтесь, що у вас активний тариф Team або Agency — API-доступ доступний з тарифу Team.

  2. Перейдіть до налаштувань профілю Serpstat і згенеруйте особистий API-токен. Один токен на акаунт.

  3. Відкрийте повну документацію API на api-docs.serpstat.com — охоплює всі доступні методи, параметри і схеми відповідей.

  4. Надішліть POST-запит до API-ендпоінту у форматі JSON-RPC 2.0: вкажіть токен, назву методу і необхідні параметри.

  5. Відстежуйте використання API credits у Профіль → Ліміти та тарифи — кожен рядок, повернений у відповіді, коштує один credit.


Ключові показники

  1. API-запити на місяць: Кількість API-викликів на вашому тарифі. Тариф Team: 200 000/місяць. Тариф Agency: 2 000 000/місяць. Тариф Individual: без API-доступу.

  2. Рядки на відповідь: Кожен рядок у відповіді API коштує один credit. Сумарний звіт коштує 5 credits за виклик. Максимум 60 000 рядків на запит.

  3. API-токен: Особистий ключ аутентифікації. Генеруйте або оновлюйте в Профіль → Налаштування. Один токен на акаунт — тестового середовища немає.

  4. JSON-RPC 2.0: Протокол, який використовує Serpstat API. Надсилайте POST-запити з назвою методу і об'єктом params; отримуйте структуровану JSON-відповідь.


Порада: Використовуйте субакаунт для розробки і тестування

Уникайте витрати основних API credits під час побудови інтеграцій — ізолюйте роботу з розробки в контрольованому субакаунті.

  1. Перейдіть до Профіль → Управління командою і додайте нового учасника з окремою електронною адресою.

  2. Виділіть субакаунту невелику кількість API credits — достатньо для тестування без ризику для основного пулу.

  3. Використовуйте API-токен субакаунту для всього процесу розробки і тестування інтеграції.

  4. Перейдіть на токен основного акаунту лише тоді, коли інтеграція повністю перевірена і готова до продакшену.

⚠️ Важливо: Окремого тестового середовища для Serpstat API немає: усі запити працюють із реальними даними та витрачають кредити. Під час розробки використовуйте тестовий субакаунт з обмеженою кількістю кредитів або напишіть нам у чат, щоб отримати тестовий доступ до API.


❓ Часті запитання

Q: Який тариф включає доступ до API? ✏️
​A: Доступ до API є починаючи з тарифу Team: Team включає 200 000 API-кредитів на місяць, Team x2 — 400 000, Agency — 2 000 000. Тариф Individual не включає доступ до API. Повне порівняння тарифів — на сторінці тарифів.
​

Q: Де знайти повну документацію API?
​A: Повний довідник API — усі методи, параметри, формати відповідей і приклади коду — доступний на api-docs.serpstat.com.
​

Q: Як рахуються API-кредити? ✏️
​A: У більшості методів кожен рядок у відповіді API коштує один кредит. Кожен запит коштує щонайменше один кредит, навіть якщо відповідь порожня. Деякі методи мають фіксовану вартість: звіт Summary — 5 кредитів за запит, аудит однієї сторінки — 10 кредитів. Методи читання даних Rank Tracker не витрачають кредити. Точну вартість вказано вгорі сторінки кожного методу в документації API.
​

Q: Чи переносяться невикористані API-кредити на наступний місяць?
​A: Ні. API-кредити оновлюються щомісяця, а невикористані не переносяться. Денний ліміт запитів діє лише в інтерфейсі сервісу. API обмежене тільки місячними кредитами та частотою запитів вашого тарифу.
​

Q: Які обмеження частоти запитів до API? ✏️
​A: Team і Team x2 — 1 запит на секунду. Agency — 10 запитів на секунду. Кожен метод повертає до 60 000 рядків. Якщо вам потрібно більше, напишіть нам у чат, і ми знайдемо рішення для вашого випадку.
​

Q: Чи можна використовувати API у власних скриптах і AI-агентах?
​A: Так. API створене для автоматизації: ваші скрипти та AI-агенти можуть напряму отримувати дані Serpstat за вашим API-токеном. Дані можна використовувати всередині компанії та у звітах для ваших клієнтів. Щоб вбудовувати, перепродавати або показувати необроблені дані Serpstat у продукті чи дашборді для ваших клієнтів, потрібна окрема угода про ліцензування даних. Напишіть нам у чат, щоб обговорити умови.
​

Q: Чи можна отримати дані для конкретної країни?
​A: Так. Вкажіть базу пошукової системи в параметрі se у кожному запиті — наприклад, g_nl для Google Нідерланди. Повний список баз є в документації API.
​

Q: Які дані доступні через API?
​A: Дані для дослідження ключових слів (частотність, складність, CPC, конкуренція, SERP), аналіз доменів і URL (органічні ключові слова, конкуренти, топ-сторінки, історія видимості), дані про зворотні посилання (посилання, домени, що посилаються, анкори), звіти з відсутніх ключових слів і порівняння доменів, а також дані Аудиту сайту та Rank Tracker. Повний список методів є в документації API.
​

Q: Наскільки актуальні дані в API?
​A: API повертає дані з баз Serpstat, а не живу видачу. Бази ключових слів оновлюються безперервно, поступово, у порядку черги. Частота оновлення може відрізнятися залежно від регіону та бази. Якщо вам потрібна видача в момент запиту, скористайтеся SERP API, доступним за запитом.
​

Q: Чи є тестове середовище або пробний доступ до API?
​A: Окремого тестового середовища (sandbox) немає: усі запити працюють із реальними даними та витрачають кредити. Щоб протестувати дані перед покупкою, напишіть нам у чат. Наша команда допоможе отримати тестовий доступ до API або пробні кредити.
​

Q: Чи є пакети лише з доступом до API?
​A: Так, за запитом. Напишіть нам у чат і вкажіть очікувану кількість запитів на місяць, і наша команда підготує пропозицію.
​

Q: Чи можна підключити Serpstat до AI-асистентів і сервісів автоматизації?
​A: Так. Serpstat MCP-сервер підключає Claude та інші асистенти з підтримкою MCP. У ChatGPT працює GPT Serpstat SEO Tool. Для n8n є окремий вузол Serpstat. Інші сервіси, наприклад Make, можуть звертатися до API через звичайний HTTP-запит.


Наступні кроки

Ви отримали відповідь на своє запитання?