Sites.Reviews Trust API

Quick domain check: Trust Score, rating, and number of reviews. Perfect for extensions and AI assistants.

The domain matches exactly: protocol, www, and trailing slash are ignored, and a subdomain is a different company. shop.example.com and example.com never respond for each other.

{
  "found": true,
  "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",
  "review_url": "https://sites.reviews/businesses/ozon-ru/review",
  "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"
}

Up to 100 domains per call — a showcase with fifty stores doesn't need to make fifty requests and waste the entire minute limit. The response is grouped by the domain you sent.

curl -X POST "https://sites.reviews/api/public/v1/check-batch" \
  -H "Content-Type: application/json" \
  -d '{"domains":["ozon.ru","unknown-shop.com"]}'

{
  "count": 2,
  "results": {
    "ozon.ru": { "found": true, "trust_score": 8.4, "total_reviews": 1247, "...": "..." },
    "unknown-shop.com": { "found": false, "submit_url": "https://sites.reviews/businesses/add?website=unknown-shop.com" }
  }
}

Trust badge as an image (SVG). The simplest integration: one line in HTML, no scripts or iframes. While the company has no ratings, the badge honestly says 'no ratings' — we don't draw a zero rating.

<a href="https://sites.reviews/businesses/ozon-ru">
  <img src="https://sites.reviews/api/public/v1/badge?domain=ozon.ru" alt="Sites.Reviews" width="196" height="48">
</a>

Full company profile: descriptions, AI summary, social media, address, category, and tags.

{
  "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"
}

{ "error": "not_found" }

Paginated list of reviews with pros/cons and English translation of the body (body_en).

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

{
  "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"
    }
  ]
}

Search for companies by name or domain. Returns brief cards. Minimum 3 characters in the query.

{
  "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"
    }
  ]
}

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

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

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

Behavior, parameters, and response format are identical to the Public API — only the base URL, key authorization, and limits differ. Profile and reviews are addressed by slug.

The key is passed only in the header. The key in the query string is not accepted: it settles in logs, browser history, and the Referer header.

Key rights are explicit: by default, it is granted public (read). Scopes write:business and quests are granted separately — a key without scopes opens nothing.

To avoid polling us on a timer: when a review is published for the domain of interest, we will call your HTTPS endpoint ourselves. The subscription is tied to the key — the review of the key disables it.

POST {ваш URL}
X-SR-Event: review.published
X-SR-Timestamp: 1772457600
X-SR-Signature: sha256=<hmac_sha256("{timestamp}.{тело}", secret)>

{
  "event": "review.published",
  "business": { "domain": "example.com", "trust_score": 8.4, "total_reviews": 12, "...": "..." },
  "review":   { "id": 5512, "stars": 5, "title": "…", "author": "…", "url": "…" }
}

Check the signature against the raw body and reject requests with X-SR-Timestamp older than 5 minutes — otherwise, an intercepted call can be replayed. Connection is through us: let us know which domain and URL.

As you approach the limit, monitor the standard response headers:

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

npx -y @sitesreviews/mcp