Рейтинги

• Список рейтингов
• Детальная страница рейтинга
• Возможные ошибки

Список рейтингов

GET /api/landings/ratings

Возвращает список всех рейтингов с топ-3 конкурентами по видимости для каждого рейтинга.

curl -X GET "https://ai.pixeltools.ru/api/landings/ratings" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ответ

{
  "data": [
    {
      "slug": "seo-rating",
      "name": "SEO рейтинг",
      "subtitle": "Рейтинг видимости брендов",
      "card_description": "Описание карточки рейтинга",
      "icon": "...",
      "description": "...",
      "url": "/ratings/seo-rating",
      "competitors": [
        {
          "name": "Brand A",
          "visibility": 85.5,
          "type": "brand"
        },
        {
          "name": "Brand B",
          "visibility": 72.3,
          "type": "competitor"
        },
        {
          "name": "Brand C",
          "visibility": 61.0,
          "type": "competitor"
        }
      ]
    }
  ]
}

Поля ответа

• slug — уникальный идентификатор рейтинга
• name — название рейтинга
• subtitle — подзаголовок (может быть null)
• card_description — описание для карточки (может быть null)
• icon — иконка рейтинга (может быть null)
• url — ссылка на страницу рейтинга
• competitors — топ-3 конкурента по видимости
• competitors[].name — название конкурента
• competitors[].visibility — процент видимости
• competitors[].type — тип: brand, competitor и т.д.

Детальная страница рейтинга

GET /api/landings/ratings/{slug}

Возвращает полные данные по конкретному рейтингу: график видимости за 12 месяцев, таблицу топ-50 конкурентов, радарную диаграмму и список промптов.

curl -X GET "https://ai.pixeltools.ru/api/landings/ratings/seo-rating" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ответ

{
  "data": {
    "projectId": 123,
    "rating": {
      "id": 1,
      "slug": "seo-rating",
      "name": "SEO рейтинг",
      "subtitle": "...",
      "card_description": "...",
      "icon": "..."
    },
    "chartData": {
      "labels": ["Апр 2025", "Май 2025", "..."],
      "datasets": [
        {
          "label": "Brand A",
          "data": [85.5, 87.2, "..."]
        }
      ]
    },
    "tableData": [
      {
        "competitor": {
          "id": 1,
          "name": "Brand A",
          "type": "brand"
        },
        "visibility": {
          "first": 80.0,
          "last": 85.5,
          "delta": 5.5
        },
        "mentions": {
          "first": 40,
          "last": 45,
          "delta": 5
        },
        "share_of_voice": {
          "first": 15.2,
          "last": 17.8,
          "delta": 2.6
        }
      }
    ],
    "radarChartData": { "..." : "..." },
    "prompts": [
      {
        "id": 1,
        "value": "Лучшие SEO инструменты 2026"
      }
    ]
  }
}

Поля ответа

• projectId — ID проекта, к которому привязан рейтинг
• rating — метаданные рейтинга (id, slug, name, subtitle, card_description, icon)
• chartData — данные графика видимости за последние 12 месяцев
• tableData — таблица топ-50 конкурентов с видимостью, упоминаниями и долей голоса
• tableData[].visibility — видимость: first (начало периода), last (конец), delta (изменение)
• tableData[].mentions — количество упоминаний
• tableData[].share_of_voice — доля голоса в процентах
• radarChartData — данные для радарной диаграммы по нейросетям
• prompts — список промптов проекта (id, value)

Возможные ошибки

401 Unauthorized

{
  "message": "Invalid API token"
}

404 Not Found

Если рейтинг с указанным slug не найден