Перейти к содержимому

API

REST API для интеграции данных ReputationHub в ваши сервисы

Основные сведения

  • Формат ответов: JSON
  • Базовый URL: https://reputationhub.ru/api
  • Аутентификация: Bearer-токен в заголовке Authorization
  • Rate limit (бесплатный тариф): 100 запросов / час

Эндпоинты

GET /api/audit?q={name} публичный

Публичный аудит компании. Возвращает Reputation Score и сводку по источникам.

GET /api/search?q={query} публичный

Поиск по базе компаний, городов и категорий. Возвращает до 5 результатов каждого типа.

GET /api/pulse публичный

Текущий агрегированный индекс рынка — средний Reputation Score по всем отслеживаемым компаниям.

Радар в ответе /api/audit

Поле radar считается так же, как репутационный радар на карточке компании: шесть осей из факторов Reputation Score, значения 0–100.

"radar": {
  "available": true,
  "axes": [
    { "key": "ratings",   "label": "Оценки",        "value": 85 },
    { "key": "volume",    "label": "Объём отзывов", "value": 100 },
    { "key": "freshness", "label": "Свежесть",      "value": null },
    { "key": "tone",      "label": "Тональность",   "value": 70 },
    { "key": "dynamics",  "label": "Динамика",      "value": 55 },
    { "key": "profile",   "label": "Профиль",       "value": 64 }
  ]
}
  • value: null — по оси нет данных (значение не подставляется).
  • available: false и пустой axes — у компании ещё нет расчёта по факторам.
  • Устарело (deprecated): плоские ключи radar.reviews, sentiment, rating, coverage, reputation, trend оставлены на один релиз для обратной совместимости и будут удалены. Используйте radar.axes.

Получение ключа API

Ключ API доступен в личном кабинете после регистрации и верификации аккаунта. Бесплатный тариф включает 100 запросов в час. Для увеличения лимитов обращайтесь на reputationhub@yandex.com.

Пример запроса

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://reputationhub.ru/api/audit?q=ВкусВилл"