> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spellit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Получение результатов анализа

> Получение аналитики (insights) по item_set внутри проекта. Требуется авторизация.



## OpenAPI

````yaml GET /insights?id_project={id_project}&id_item_set={id_item_set}
openapi: 3.1.0
info:
  title: SpellIt API
  description: >-
    API для обработки Items через создание проекта, загрузку Item Set и загрузку
    Items
  version: 1.0.0
servers:
  - url: https://api.spellit.ai/api/
security: []
paths:
  /insights?id_project={id_project}&id_item_set={id_item_set}:
    get:
      description: >-
        Получение аналитики (insights) по item_set внутри проекта. Требуется
        авторизация.
      parameters:
        - name: id_project
          in: query
          required: true
          description: ID проекта
          schema:
            type: integer
        - name: id_item_set
          in: query
          required: true
          description: ID item_set
          schema:
            type: integer
      responses:
        '200':
          description: Успешное получение аналитики (insights)
          content:
            application/json:
              schema:
                type: object
                properties:
                  project_id:
                    type: integer
                  item_set_id:
                    type: integer
                  created_at:
                    type: string
                    format: date-time
                  insights:
                    type: array
                    items:
                      type: object
                      properties:
                        score:
                          type: number
                          description: Балл по критерию, может быть как число, так и слово
                        reasons:
                          type: string
                          description: Объяснение, почему поставлен конкретный балл
                        quotes:
                          type: string
                          description: Цитата из звонка, объясняющая постановку балла
              examples:
                default:
                  value:
                    project_id: 1
                    item_set_id: 1
                    created_at: '2025-01-01T10:10:10'
                    insights:
                      - criterion_name: Уточнение удобства разговора
                        score: 1
                        reasons: >-
                          Менеджер уточнил, удобно ли клиенту разговаривать, что
                          соответствует критерию. Рекомендация: продолжать
                          спрашивать об удобстве разговора в начале звонка.
                        quotes: '00:00:04.773 - Продавец: "Удобно сейчас пообщаться?"'
                      - criterion_name: Уточнение удобства разговора
                        score: 0
                        reasons: >-
                          Менеджер не уточнил, удобно ли клиенту разговаривать.
                          Это важный момент для проявления заботы о клиенте и
                          повышения лояльности. Рекомендация: всегда в начале
                          разговора спрашивать, удобно ли сейчас общаться.
                        quotes: ''
                      - criterion_name: Уточнение потребностей клиента
                        score: ''
                        reasons: >-
                          Менеджер частично выявил потребности, конкретных тегов
                          не удалось определить.
                        quotes: ''
                      - criterion_name: Talk ratio Продавца
                        score: 67%
                        reasons: >-
                          Диалог длился примерно 2100 секунд (с 00:00:02 до
                          00:35:21). Продавец говорил около 1400 секунд, Клиент
                          — около 700 секунд. У Продавца — примерно 90 реплик, у
                          Клиента — около 60. Соотношение: 1400 / 2100 = 67%.
                        quotes: ''
                      - criterion_name: Звучание, тон и корректность Продавца
                        score: Позитив
                        reasons: >-
                          Тональность Продавца: Позитив — доброжелательный,
                          поддерживающий, эмоционально включённый стиль
                          ("Спасибо большое", "Если будут вопросы — обязательно
                          пишите"). Тональность Клиента: Нейтрально/Позитив —
                          спокойная, местами заинтересованная, иногда с
                          сомнениями, но без негатива ("Мне все откликнулось",
                          "Спасибо вам большое за информацию, что позвонили
                          очень быстро"). Итоговая оценка: Позитив, так как
                          Продавец был позитивен и поддерживал доброжелательный
                          стиль вне зависимости от реакции Клиента.
                        quotes: ''
        '400':
          description: Неверные параметры запроса
          content:
            application/json:
              example:
                detail: id_project is required
        '401':
          description: Ошибка аутентификации
          content:
            application/json:
              example:
                detail: Invalid auth
        '422':
          description: Ошибка валидации
          content:
            application/json:
              example:
                detail: Invalid input data
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: API-Access-Key
      description: API-ключ для доступа к эндпоинтам
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT-токен для авторизации (Bearer Token)

````