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 Операції

post/v1/beta/waveinflu/similar

Схожі автори

Знаходить схожих авторів за обов'язковим 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 перелік
  
  Чи порівнюються minPlayCount / maxPlayCount з медіанною або середньою кількістю відтворень.
  
  значення
  median
  average
- regions
  Тип: array string[]
  
  Регіони авторів (коди країн ISO), наприклад ["US", "GB", "JP"].
- workspaceDeduplicationEnabled
  Тип: boolean
  
  Якщо true, авторів, уже збережених у вашому робочому просторі, виключено з результатів.
limit
Тип: integer
мін.:
1
макс.:
100

Integer numbers.
platform
Тип: string перелік
значення
- 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

Відповідь із помилкою; наскрізні відповіді апстріму можуть використовувати формати постачальника

application/json

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

Схожих авторів повернено

Схожі автори

АвтентифікаціяRequired

Creator Data

Схожі автори

Довідкові ціни