Felo API PlatformFelo API Platform
Все эндпоинты Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

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

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data Операции

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

​

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

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

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

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

Тело
обязательно
application/json
  • target_account
    Тип: string
    обязательно

    Исходный аккаунт: хэндл креатора (с @ или без) либо URL профиля, для которого нужно найти похожих креаторов.

  • filters
    Тип: object

    Необязательные фильтры, применяемые перед сопоставлением. Все поля необязательны.

    • creatorTypes
      Тип: array string[]

      Типы аккаунтов креаторов, например ["individual", "brand"].

    • ethnicities
      Тип: array string[]

      Предполагаемая этническая принадлежность креаторов.

    • faceVisibilities
      Тип: array string[]

      Классификации видимости лица, например ["clear_face", "mixed", "no_face"].

    • genders
      Тип: array string[]

      Предполагаемый пол креаторов, например ["female", "male"].

    • languages
      Тип: array string[]

      Языки креаторов, например ["en", "ja", "zh-cn"].

    • maxFollowers
      Тип: number

      Максимальное количество подписчиков / подписчиков канала.

    • maxPlayCount
      Тип: number

      Максимальное количество воспроизведений / просмотров, измеряемое по playCountMetric.

    • minFollowers
      Тип: number

      Минимальное количество подписчиков / подписчиков канала.

    • minPlayCount
      Тип: number

      Минимальное количество воспроизведений / просмотров, измеряемое по playCountMetric.

    • playCountMetric
      Тип: string enum

      Сравниваются ли minPlayCount / maxPlayCount с медианным или средним количеством воспроизведений.

      значения
      • median
      • average
    • regions
      Тип: array string[]

      Регионы креаторов (коды стран ISO), например ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Тип: boolean

      Если true, креаторы, уже сохранённые в вашем рабочем пространстве, исключаются из результатов.

  • limit
    Тип: integer
    мин.:  
    1
    макс.:  
    100

    Integer numbers.

  • platform
    Тип: string enum
    значения
    • instagram
    • tiktok
    • youtube
Ответы
  • 200
    Тип: object

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

    • billingRequestId
      Тип: string

      Справочная информация о биллинге провайдера, а не квитанция о биллинге Felo.

    • data
      Тип: object · ResponseEb32A34A5274_CreatorSearchData
      • count
        Тип: number

        Количество доставленных креаторов. Биллинг рассчитывается по этому количеству.

      • items
        Тип: array object[] · ResponseEb32A34A5274_Creator[]

        Совпавшие креаторы, отсортированные по score по убыванию.

        Сопоставленный креатор. Поля одинаковы в Similar Creators и AI Search.

        • accountPositioning
          Тип: array string[]

          Короткие теги, сгенерированные ИИ, описывающие нишу/позиционирование креатора.

        • ageRange
          Тип: string

          Предполагаемый возрастной диапазон (например, 25_34) или unknown.

        • aiDescription
          Тип: string

          Сгенерированная ИИ сводка контента, стиля и типичных визуальных материалов креатора.

        • averageEngagementRate
          Тип: number

          Средний уровень вовлечённости (0–1).

        • averagePlayCount
          Тип: number

          Среднее число воспроизведений/просмотров за последние публикации.

        • biography
          Тип: string

          Текст биографии профиля.

        • email
          Тип: string | null

          Контактный адрес электронной почты, извлечённый из профиля, если доступен.

        • ethnicity
          Тип: string

          Предполагаемая этническая принадлежность или unknown.

        • faceVisibility
          Тип: string

          Классификация видимости лица, например clear_face, mixed, no_face.

        • followerCount
          Тип: number

          Количество подписчиков.

        • fullName
          Тип: string

          Отображаемое имя креатора.

        • gender
          Тип: string

          Выведенный пол или unknown.

        • id
          Тип: string

          ID креатора на стороне платформы.

        • language
          Тип: string

          Основной язык контента.

        • medianEngagementRate
          Тип: number

          Медианный показатель вовлечённости (0–1).

        • medianPlayCount
          Тип: number

          Медианное число воспроизведений/просмотров по последним публикациям.

        • platform
          Тип: string

          Платформа, к которой относится креатор: instagram, tiktok или youtube.

        • profileUrl
          Тип: string

          URL профиля креатора.

        • region
          Тип: string

          Регион креатора (код страны ISO).

        • score
          Тип: number

          Оценка релевантности совпадения (0–1), сортировка по убыванию.

        • username
          Тип: string

          Хэндл креатора (без ведущего @).

    • requestId
      Тип: string

      ID запроса для поддержки и мониторинга.

    application/json
  • 400

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

  • 401

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

  • 402

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

  • 403

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

  • 429

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

  • 502

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

  • 503

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

  • 504

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

  • default

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

    application/json
Request Example for post/v1/beta/waveinflu/similar
curl https://openapi.felo.ai/v1/beta/waveinflu/similar \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "platform": "youtube",
  "target_account": "@onkimia",
  "limit": 25,
  "filters": {
    "regions": [
      ""
    ],
    "languages": [
      ""
    ],
    "minFollowers": 1,
    "maxFollowers": 1,
    "minPlayCount": 1,
    "maxPlayCount": 1,
    "playCountMetric": "median",
    "genders": [
      ""
    ],
    "ethnicities": [
      ""
    ],
    "creatorTypes": [
      ""
    ],
    "faceVisibilities": [
      ""
    ],
    "workspaceDeduplicationEnabled": true
  }
}'

{
  "requestId": "req-b33",
  "billingRequestId": "a328145e-3cc9-45c7-89f9-a5f15b236d4f",
  "data": {
    "items": [
      {
        "id": "string",
        "username": "string",
        "fullName": "string",
        "biography": "string",
        "email": null,
        "followerCount": 1,
        "region": "string",
        "language": "string",
        "averagePlayCount": 1,
        "medianPlayCount": 1,
        "averageEngagementRate": 1,
        "medianEngagementRate": 1,
        "gender": "string",
        "ageRange": "string",
        "ethnicity": "string",
        "faceVisibility": "string",
        "accountPositioning": [
          "string"
        ],
        "aiDescription": "string",
        "platform": "string",
        "profileUrl": "string",
        "score": 1
      }
    ],
    "count": 2
  }
}

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

Similar Creators

Нужна помощь?