REST · JSON · CORS

API доверия Sites.Reviews

Trust Score, отзывы и проверка компаний — прямо в вашем продукте, расширении или ИИ-ассистенте. Public API без ключа за 30 секунд, Authenticated API по ключу для партнёров.

Документация Войти и получить ключ

Без ключа — 60 req/min Read-only CORS * MCP для ИИ

Два яруса

Выберите подходящий доступ

Одни и те же данные доступны бесплатно без ключа и по ключу с повышенными лимитами. Начните с Public, переходите на Authenticated, когда нужен объём.

Ярус 1 · Public

Public API — без ключа

Для ИИ-ассистентов, браузерных расширений и быстрых интеграций. Подключение без регистрации.

База: https://sites.reviews/api/public/v1
Без авторизации, только чтение
60 запросов в минуту на IP
CORS * — работает из браузера
check · business · reviews · search

Документация Public

Ярус 2 · Authenticated

Authenticated API — по ключу

Для партнёров: тот же набор данных, индивидуальные лимиты и приоритет. Ключ выдаётся в личном кабинете.

База: https://sites.reviews/api/v1
Заголовок Authorization: Bearer sr_…
или X-API-Key: sr_…
Индивидуальный лимит на ключ
check · search · business · reviews

Войти и получить ключ

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

Первый запрос за 30 секунд

Проверьте любой домен прямо сейчас — ключ не нужен. Ответ в JSON, доступен из браузера благодаря открытому CORS.

Запрос

curl "https://sites.reviews/api/public/v1/check?domain=ozon.ru"

Ответ 200 OK

{
  "id": 1101,
  "name": "OZON",
  "slug": "ozon-ru",
  "website": "https://www.ozon.ru",
  "trust_score": 8.4,
  "avg_ratings": 4.2,
  "total_reviews": 1247,
  "is_verified": true,
  "url": "https://sites.reviews/businesses/ozon-ru",
  "logo": "https://sites.reviews/storage/logos/ozon.png"
}

Ярус 1

Public API

Открытый read-only доступ без авторизации. Базовый URL https://sites.reviews/api/public/v1. Лимит — 60 запросов в минуту на IP, CORS *.

GET /check?domain={domain}

Быстрая проверка домена: Trust Score, рейтинг и число отзывов. Идеально для расширений и ИИ-ассистентов.

Параметр	Тип	Описание
`domain`	string	Домен без протокола, напр. `ozon.ru`

Ответ — компания найдена

{
  "id": 1101,
  "name": "OZON",
  "slug": "ozon-ru",
  "website": "https://www.ozon.ru",
  "trust_score": 8.4,
  "avg_ratings": 4.2,
  "total_reviews": 1247,
  "is_verified": true,
  "url": "https://sites.reviews/businesses/ozon-ru",
  "logo": "https://sites.reviews/storage/logos/ozon.png"
}

Ответ — нет в каталоге

{
  "found": false,
  "domain": "unknown-shop.com",
  "submit_url": "https://sites.reviews/businesses/add?domain=unknown-shop.com"
}

GET /business/{domain}

Полный профиль компании: описания, AI-сводка, соцсети, адрес, категория и теги.

Ответ 200 OK

{
  "id": 1101,
  "name": "OZON",
  "slug": "ozon-ru",
  "website": "https://www.ozon.ru",
  "trust_score": 8.4,
  "avg_ratings": 4.2,
  "total_reviews": 1247,
  "is_verified": true,
  "url": "https://sites.reviews/businesses/ozon-ru",
  "logo": "https://sites.reviews/storage/logos/ozon.png",
  "short_description": "Маркетплейс №1 в России",
  "description": "OZON — один из крупнейших маркетплейсов...",
  "ai_about": "Компания работает с 1998 года...",
  "ai_summary": "Покупатели хвалят скорость доставки и...",
  "social_links": {
    "instagram": "https://instagram.com/ozonru",
    "vk": "https://vk.com/ozon"
  },
  "address": "Москва, Пресненская наб. 10",
  "category_id": 3,
  "tags": ["marketplace", "ecommerce", "retail"],
  "created_at": "2024-11-02T09:14:00Z"
}

Ответ 404 Not Found

{ "error": "not_found" }

GET /reviews/{domain}

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

Параметр	Тип	По умолчанию	Описание
`page`	int	1	Номер страницы
`per_page`	int	20	Отзывов на страницу

Запрос

curl "https://sites.reviews/api/public/v1/reviews/ozon-ru?page=1&per_page=20"

Ответ 200 OK

{
  "business": {
    "id": 1101,
    "name": "OZON",
    "slug": "ozon-ru",
    "trust_score": 8.4
  },
  "page": 1,
  "per_page": 20,
  "total": 1247,
  "reviews": [
    {
      "id": 58213,
      "title": "Быстрая доставка",
      "body": "Заказ приехал за один день, всё в порядке.",
      "body_en": "The order arrived in one day, everything is fine.",
      "stars": 5,
      "pros": "Скорость, упаковка",
      "cons": "Нет",
      "author": "Ирина М.",
      "created_at": "2025-12-18T11:42:00Z"
    }
  ]
}

GET /search?q={query}

Поиск компаний по названию или домену. Возвращает краткие карточки. Минимум 3 символа в запросе.

Параметр	Тип	По умолчанию	Описание
`q`	string	—	Строка поиска, ≥ 3 символов
`limit`	int	10	Максимум результатов

Ответ 200 OK

{
  "count": 2,
  "results": [
    {
      "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"
    },
    {
      "id": 1102,
      "name": "OZON Банк",
      "slug": "ozon-bank",
      "trust_score": 7.6,
      "avg_ratings": 3.9,
      "total_reviews": 318,
      "url": "https://sites.reviews/businesses/ozon-bank"
    }
  ]
}

Ответ 422 — запрос короче 3 символов

{
  "error": "validation_error",
  "message": "Query must be at least 3 characters."
}

Ярус 2

Authenticated API

Тот же набор данных с индивидуальными лимитами. Базовый URL https://sites.reviews/api/v1. Каждый запрос подписывается ключом sr_… одним из двух заголовков:

Вариант 1 — Bearer-токен

curl "https://sites.reviews/api/v1/check?domain=ozon.ru" \
  -H "Authorization: Bearer sr_live_8f2c91a4e7b0d36f"

Вариант 2 — X-API-Key

curl "https://sites.reviews/api/v1/check?domain=ozon.ru" \
  -H "X-API-Key: sr_live_8f2c91a4e7b0d36f"

Ключ выдаётся в личном кабинете — без писем и заявок. Войдите, чтобы создать ключ.

Эндпоинты /v1

Поведение, параметры и форма ответа идентичны Public API — отличается только базовый URL, авторизация по ключу и лимиты. Профиль и отзывы адресуются по slug.

Метод	Путь	Назначение
GET	`/v1/check?domain={domain}`	Проверка домена
GET	`/v1/search?q={query}`	Поиск компаний
GET	`/v1/business/{slug}`	Полный профиль
GET	`/v1/reviews/{slug}`	Список отзывов

Справочник

Лимиты и заголовки

Параметр	Public API	Authenticated API
Авторизация	не нужна	`Bearer sr_…` или `X-API-Key`
Лимит частоты	60 req/min на IP	индивидуально на ключ
Доступ	только чтение	только чтение
CORS	`*`	`*`
Кеш ответа	до 60 секунд	до 60 секунд

При приближении к лимиту следите за стандартными заголовками ответа:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
Retry-After: 31          # только в ответе 429

Ошибки

Код	Когда	Тело ответа
404	Компания не найдена	`{ "error": "not_found" }`
422	Параметр не прошёл валидацию (напр. q < 3)	`{ "error": "validation_error", "message": "…" }`
429	Превышен лимит частоты	`{ "error": "rate_limited", "retry_after": 31 }`

Интеграции

Для ИИ-ассистентов

Подключите Sites.Reviews к Claude, Cursor и другим ИИ через MCP-сервер — ассистент сможет проверять компании и читать отзывы прямо в диалоге.

Запуск MCP-сервера

npx -y @sitesreviews/mcp

MCP-сервер

Готовые инструменты check / search / reviews для ИИ-ассистентов. Установка одной командой.

sites-reviews-mcp

OpenAPI и документация

Полная OpenAPI-спецификация, примеры SDK и справочник всех эндпоинтов.

sites-reviews-api

Готовы встроить доверие?

Начните с Public API без ключа прямо сейчас, а для повышенных лимитов создайте ключ в личном кабинете за минуту.

К документации Войти и получить ключ