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

SERPHub REST API

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

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

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

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

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

curl

curl https://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 Добавить сайт

DELETE /sites/{id} Удалить сайт

Аудиты

GET /sites/{id}/audits Список аудитов сайта

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

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

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

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

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

GET /sites/{id}/keywords/top Топ слов по кликам

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

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

Бэклинки

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

POST /sites/{id}/backlinks/verify Запустить проверку ссылок

GET /sites/{id}/backlinks/stats Статистика бэклинков

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

GET /sites/{id}/ai-mentions Список ИИ-упоминаний

GET /sites/{id}/ai-mentions/sov Share of Voice

POST /sites/{id}/ai-mentions/run Проверить ИИ-упоминания

Конкуренты

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

POST /sites/{id}/competitors Добавить конкурента

DELETE /sites/{id}/competitors/{competitorId} Удалить конкурента

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

Bearer Токен (Sanctum)

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

Лимиты (Rate Limits)

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

Тариф	Запросов/мин	Запросов/день
Agency	120	50,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 включен в планы Agency и Enterprise. Зарегистрируйтесь, чтобы начать.

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