# Похожие креаторы

**API:** Data API

**Endpoint:** `POST /v1/beta/waveinflu/similar`

**Tags:** Creator Data

Находит похожих креаторов по обязательному target_account. platform необязателен, по умолчанию youtube и поддерживает instagram, tiktok и youtube. Используйте документированные фильтры, чтобы сузить результаты. billingRequestId — это ссылка провайдера, а не квитанция биллинга Felo.

### Справочная информация о ценах

- Тарификация: тарифицируемые единицы ответа.
- Справочная оценка запроса: USD 0.124425.
- Базовая стоимость единицы: USD 0.004977.
- Единица ресурса: `similar_creator_point`.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
- Базовые стоимости не определяют итоговую цену для клиента, в том числе когда они равны нулю.

Только справочные метаданные, а не котировка для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "object",
  "properties": {
    "platform": {
      "default": "youtube",
      "enum": [
        "instagram",
        "tiktok",
        "youtube"
      ],
      "type": "string"
    },
    "target_account": {
      "type": "string",
      "description": "Исходный аккаунт: хэндл креатора (с @ или без) либо URL профиля, для которого нужно найти похожих креаторов.",
      "example": "@onkimia"
    },
    "limit": {
      "default": 25,
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "filters": {
      "type": "object",
      "description": "Необязательные фильтры, применяемые перед сопоставлением. Все поля необязательны.",
      "properties": {
        "regions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Регионы креаторов (коды стран ISO), например [\"US\", \"GB\", \"JP\"]."
        },
        "languages": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Языки креаторов, например [\"en\", \"ja\", \"zh-cn\"]."
        },
        "minFollowers": {
          "type": "number",
          "description": "Минимальное количество подписчиков / подписчиков канала."
        },
        "maxFollowers": {
          "type": "number",
          "description": "Максимальное количество подписчиков / подписчиков канала."
        },
        "minPlayCount": {
          "type": "number",
          "description": "Минимальное количество воспроизведений / просмотров, измеряемое по `playCountMetric`."
        },
        "maxPlayCount": {
          "type": "number",
          "description": "Максимальное количество воспроизведений / просмотров, измеряемое по `playCountMetric`."
        },
        "playCountMetric": {
          "type": "string",
          "enum": [
            "median",
            "average"
          ],
          "description": "Сравниваются ли `minPlayCount` / `maxPlayCount` с медианным или средним количеством воспроизведений."
        },
        "genders": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Предполагаемый пол креаторов, например [\"female\", \"male\"]."
        },
        "ethnicities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Предполагаемая этническая принадлежность креаторов."
        },
        "creatorTypes": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Типы аккаунтов креаторов, например [\"individual\", \"brand\"]."
        },
        "faceVisibilities": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Классификации видимости лица, например [\"clear_face\", \"mixed\", \"no_face\"]."
        },
        "workspaceDeduplicationEnabled": {
          "type": "boolean",
          "description": "Если true, креаторы, уже сохранённые в вашем рабочем пространстве, исключаются из результатов."
        }
      }
    }
  },
  "required": [
    "target_account"
  ]
}
```

## Responses

### 200 — Похожие креаторы возвращены

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "requestId": {
      "type": "string",
      "description": "ID запроса для поддержки и мониторинга.",
      "example": "req-b33"
    },
    "billingRequestId": {
      "type": "string",
      "description": "Справочная информация о биллинге провайдера, а не квитанция о биллинге Felo.",
      "example": "a328145e-3cc9-45c7-89f9-a5f15b236d4f"
    },
    "data": {
      "$ref": "#/components/schemas/ResponseEb32A34A5274_CreatorSearchData"
    }
  }
}
```

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```

## Schema definitions

### ResponseEb32A34A5274_Creator

`#/components/schemas/ResponseEb32A34A5274_Creator`

```json
{
  "type": "object",
  "description": "Сопоставленный креатор. Поля одинаковы в Similar Creators и AI Search.",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID креатора на стороне платформы."
    },
    "username": {
      "type": "string",
      "description": "Хэндл креатора (без ведущего @)."
    },
    "fullName": {
      "type": "string",
      "description": "Отображаемое имя креатора."
    },
    "biography": {
      "type": "string",
      "description": "Текст биографии профиля."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Контактный адрес электронной почты, извлечённый из профиля, если доступен."
    },
    "followerCount": {
      "type": "number",
      "description": "Количество подписчиков."
    },
    "region": {
      "type": "string",
      "description": "Регион креатора (код страны ISO)."
    },
    "language": {
      "type": "string",
      "description": "Основной язык контента."
    },
    "averagePlayCount": {
      "type": "number",
      "description": "Среднее число воспроизведений/просмотров за последние публикации."
    },
    "medianPlayCount": {
      "type": "number",
      "description": "Медианное число воспроизведений/просмотров по последним публикациям."
    },
    "averageEngagementRate": {
      "type": "number",
      "description": "Средний уровень вовлечённости (0–1)."
    },
    "medianEngagementRate": {
      "type": "number",
      "description": "Медианный показатель вовлечённости (0–1)."
    },
    "gender": {
      "type": "string",
      "description": "Выведенный пол или `unknown`."
    },
    "ageRange": {
      "type": "string",
      "description": "Предполагаемый возрастной диапазон (например, `25_34`) или `unknown`."
    },
    "ethnicity": {
      "type": "string",
      "description": "Предполагаемая этническая принадлежность или `unknown`."
    },
    "faceVisibility": {
      "type": "string",
      "description": "Классификация видимости лица, например `clear_face`, `mixed`, `no_face`."
    },
    "accountPositioning": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Короткие теги, сгенерированные ИИ, описывающие нишу/позиционирование креатора."
    },
    "aiDescription": {
      "type": "string",
      "description": "Сгенерированная ИИ сводка контента, стиля и типичных визуальных материалов креатора."
    },
    "platform": {
      "type": "string",
      "description": "Платформа, к которой относится креатор: instagram, tiktok или youtube."
    },
    "profileUrl": {
      "type": "string",
      "description": "URL профиля креатора."
    },
    "score": {
      "type": "number",
      "description": "Оценка релевантности совпадения (0–1), сортировка по убыванию."
    }
  }
}
```

### ResponseEb32A34A5274_CreatorSearchData

`#/components/schemas/ResponseEb32A34A5274_CreatorSearchData`

```json
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/ResponseEb32A34A5274_Creator"
      },
      "description": "Совпавшие креаторы, отсортированные по `score` по убыванию."
    },
    "count": {
      "type": "number",
      "description": "Количество доставленных креаторов. Биллинг рассчитывается по этому количеству.",
      "example": 2
    }
  }
}
```