v0.2.0-beta

OpenAPI 3.1.0

Pencipta Serupa

Felo API Support

MIT

Pelayan

https://openapi.felo.ai

Pustaka Klien

Shell Curl

Creator Data

Creator discovery and public contact information.

Creator Data Operasi

post/v1/beta/waveinflu/similar

Pencipta Serupa

Cari pencipta serupa menggunakan target_account yang diperlukan. platform adalah pilihan, lalai kepada youtube, dan menyokong instagram, tiktok dan youtube. Ikuti penapis yang didokumenkan untuk menyempitkan hasil. billingRequestId ialah rujukan penyedia, bukan resit pengebilan Felo.

Rujukan harga

Pemeteran: Unit respons dimeterkan.
Anggaran rujukan setiap permintaan: USD 0.124425.
Asas kos unit: USD 0.004977.
Unit sumber: similar_creator_point.
Pengganda pelanggan rujukan: 1.0. Jangan gunakan semula pada amaun pelanggan yang telah diselesaikan.
Asas kos tidak menentukan harga pelanggan akhir, termasuk apabila sifar.

Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.

Badan

wajib

application/json

target_account
Jenis: string
wajib

Akaun seed: handle pencipta (dengan atau tanpa @) atau URL profil untuk mencari pencipta serupa.
filters
Jenis: object

Penapis pilihan yang digunakan sebelum pemadanan. Semua medan adalah pilihan.
- creatorTypes
  Jenis: array string[]
  
  Jenis akaun pencipta, contohnya ["individual", "brand"].
- ethnicities
  Jenis: array string[]
  
  Etnik pencipta yang disimpulkan.
- faceVisibilities
  Jenis: array string[]
  
  Klasifikasi keterlihatan wajah, contohnya ["clear_face", "mixed", "no_face"].
- genders
  Jenis: array string[]
  
  Jantina pencipta yang disimpulkan, contohnya ["female", "male"].
- languages
  Jenis: array string[]
  
  Bahasa pencipta, contohnya ["en", "ja", "zh-cn"].
- maxFollowers
  Jenis: number
  
  Bilangan pengikut / pelanggan maksimum.
- maxPlayCount
  Jenis: number
  
  Bilangan main / tontonan maksimum, diukur dengan playCountMetric.
- minFollowers
  Jenis: number
  
  Bilangan pengikut / pelanggan minimum.
- minPlayCount
  Jenis: number
  
  Bilangan main / tontonan minimum, diukur dengan playCountMetric.
- playCountMetric
  Jenis: string enum
  
  Sama ada minPlayCount / maxPlayCount dibandingkan dengan median atau purata bilangan main.
  
  nilai
  median
  average
- regions
  Jenis: array string[]
  
  Wilayah pencipta (kod negara ISO), contohnya ["US", "GB", "JP"].
- workspaceDeduplicationEnabled
  Jenis: boolean
  
  Apabila true, pencipta yang sudah disimpan dalam ruang kerja anda dikecualikan daripada hasil.
limit
Jenis: integer
min:
1
maks:
100

Integer numbers.
platform
Jenis: string enum
nilai
- instagram
- tiktok
- youtube

Respons

200
Jenis: object

Pencipta serupa dikembalikan.
billingRequestId
Jenis: string

Rujukan pengebilan penyedia, bukan resit pengebilan Felo.

data
Jenis: object · ResponseEb32A34A5274_CreatorSearchData
count
Jenis: number

Bilangan pencipta yang dihantar. Pengebilan adalah berdasarkan bilangan yang dihantar ini.

items
Jenis: array object[] · ResponseEb32A34A5274_Creator[]

Pencipta yang dipadankan, diisih mengikut score menurun.

Pencipta yang dipadankan. Medan konsisten merentas Similar Creators dan AI Search.

accountPositioning
Jenis: array string[]

Tag pendek yang dijana AI, merumuskan niche / kedudukan pencipta.

ageRange
Jenis: string

Julat umur yang disimpulkan (contohnya 25_34), atau unknown.

aiDescription
Jenis: string

Ringkasan yang dijana AI tentang kandungan, gaya dan visual lazim pencipta.

averageEngagementRate
Jenis: number

Purata kadar penglibatan (0–1).

averagePlayCount
Jenis: number

Purata kiraan main / tontonan merentas siaran terkini.

biography
Jenis: string

Teks bio profil.

email
Jenis: string | null

E-mel hubungan yang diekstrak daripada profil, apabila tersedia.

ethnicity
Jenis: string

Etnik yang disimpulkan, atau unknown.

faceVisibility
Jenis: string

Klasifikasi keterlihatan wajah, contohnya clear_face, mixed, no_face.

followerCount
Jenis: number

Bilangan pengikut / pelanggan.

fullName
Jenis: string

Nama paparan pencipta.

gender
Jenis: string

Jantina yang disimpulkan, atau unknown.

id
Jenis: string

ID pencipta di sebelah platform.

language
Jenis: string

Bahasa kandungan utama.

medianEngagementRate
Jenis: number

Kadar penglibatan median (0–1).

medianPlayCount
Jenis: number

Median bilangan main / tonton merentas siaran terkini.

platform
Jenis: string

Platform tempat pencipta ini berada: instagram, tiktok atau youtube.

profileUrl
Jenis: string

URL profil pencipta.

region
Jenis: string

Wilayah pencipta (kod negara ISO).

score
Jenis: number

Skor kaitan padanan (0–1), diisih menurun.

username
Jenis: string

Handle pencipta (tanpa @ di hadapan).

requestId
Jenis: string

ID permintaan untuk sokongan dan pemantauan.
application/json
400

Permintaan tidak dapat diproses. Semak parameter permintaan.
401

Kunci API Felo yang sah diperlukan.
402

Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
403

Akaun tidak dibenarkan melakukan operasi ini.
429

Had permintaan atau had perbelanjaan telah dicapai.
502

Perkhidmatan tidak dapat menyelesaikan permintaan.
503

API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
504

Perkhidmatan tamat masa semasa memproses permintaan.
default

Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia

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

Tunjukkan Skema

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

Pencipta serupa dikembalikan.

Pencipta Serupa

PengesahanRequired

Creator Data

Pencipta Serupa

Rujukan harga