Разработчикам

SERPHub REST API

35+ эндпоинтов. JSON-ответы. Sanctum токены. Экспортируйте ваши SEO-данные в любой инструмент, дашборд или рабочий процесс.

Получить токен Отдел продаж

Быстрый старт

Сгенерируйте API-токен Sanctum в настройках аккаунта, а затем передавайте его как Bearer токен в каждом запросе.

1 Авторизуйтесь → Настройки → Безопасность → Токены API → Создать токен
2 Передавайте токен в заголовке Authorization: Bearer YOUR_TOKEN при каждом запросе
3 Базовый URL: https://dev.serphub.io/api/v1

curl

curl https://dev.serphub.io/api/v1/sites \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Ответ (200)

{
  "data": [
    {
      "id": 42,
      "domain": "example.com",
      "health_score": 91,
      "last_audit_at": "2026-05-20T08:15:00Z"
    }
  ]
}

Справочник API

Все эндпоинты возвращают JSON. Для POST/PUT операций требуется тело POST в формате JSON с Content-Type: application/json.

Сайты

GET /sites Список всех сайтов

GET /sites/{id} Детали сайта

POST /sites Добавить сайт

Аудиты

GET /sites/{id}/audit Последний аудит

POST /sites/{id}/audit Запустить новый аудит

GET /sites/{id}/audit/progress Прогресс аудита

GET /sites/{id}/issues Открытые SEO ошибки

Ключевые слова

GET /sites/{id}/keywords Позиции (GSC)

GET /sites/{id}/pages Показатели страниц

GET /sites/{id}/cannibalization Каннибализация запросов

GET /sites/{id}/search-intent Распределение интентов

Бэклинки

GET /sites/{id}/backlinks Список ссылающихся страниц

GET /sites/{id}/internal-links Возможности внутренних ссылок

GET /sites/{id}/content-decay Отчет об устаревании контента

ИИ-упоминания

GET /sites/{id}/aeo Статус готовности AEO

POST /sites/{id}/ai/chat Отправить сообщение ИИ-чату

Конкуренты

GET /sites/{id}/competitors Список конкурентов

GET /sites/{id}/visibility Обзор видимости

GET /sites/{id}/search-overview Обзор поиска

Аутентификация и лимиты

Bearer Токен (Sanctum)

Во всех API запросах должен быть валидный Sanctum access-токен. Токены создаются в Настройки → Безопасность → Токены API. Токены не имеют срока действия, но их можно отозвать в любой момент.

Лимиты (Rate Limits)

Доступ к API предоставляется на тарифах с квотой API — Pro, Agency и Enterprise.

Тариф	Запросов/мин	Вызовов/мес
Pro	60	1,000
Agency	60	10,000
Enterprise	Индивидуально	Индивидуально

Ошибки

API использует стандартные HTTP-коды статусов. При ошибке возвращается JSON-объект с полем message. 401 = неверный токен, 403 = доступ запрещен, 422 = ошибка валидации, 429 = превышен лимит.

Пример ошибки

HTTP/1.1 422
{
  "message": "Validation error",
  "errors": {
    "domain": [
      "The domain field is required."
    ]
  }
}

Готовы к интеграции?

Доступ к API включен в планы Pro и выше. Зарегистрируйтесь, чтобы начать.

Начать Запрос для Enterprise