Public API

Авторизация

Каждый запрос требует Bearer-токена или заголовка X-API-Key. Получить ключ: [email protected].

curl https://sites.reviews/api/v1/check?domain=example.com \
  -H "Authorization: Bearer sr_YOUR_TOKEN_HERE"

GET /v1/check

Быстрая проверка домена: есть ли отзывы. Используется в browser extension.

{
  "id": 1101,
  "name": "OZON",
  "slug": "ozon.ru",
  "trust_score": 8.4,
  "avg_ratings": 4.2,
  "total_reviews": 1247,
  "url": "https://sites.reviews/businesses/ozon.ru"
}

GET /v1/search

Поиск компаний по названию или домену.

GET /v1/search?q=ozon&limit=10

GET /v1/business/{slug}

Полная карточка компании: описание, AI-сводка, соцсети, адрес.

GET /v1/reviews/{slug}

Пагинированный список отзывов с pros/cons и EN-переводом (body_en).

GET /v1/reviews/ozon.ru?page=1&per_page=20

POST /v1/quests/check-review

Проверка квеста «оставил отзыв» по external_user_id. Scope: quests.

POST /v1/quests/check-review
{
  "domain": "ozon.ru",
  "external_user_id": "lbm_12345",
  "min_chars": 100,
  "min_stars": 4
}

Лимиты и тарифы

Стандартный токен — 60 req/min. Для widget/extension — 120 req/min. Premium с whitelabel — по запросу.