Felo API PlatformFelo API Platform
Semua endpoint Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

Kreator Serupa

Felo API Support
MIT
Server:https://openapi.felo.ai
Pustaka Klien
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data Operasi

Kreator Serupa

​

Temukan kreator serupa menggunakan target_account yang wajib. platform bersifat opsional, default-nya youtube, dan mendukung instagram, tiktok, dan youtube. Ikuti filter yang didokumentasikan untuk mempersempit hasil. billingRequestId adalah referensi penyedia, bukan bukti tagihan Felo.

Referensi harga

  • Metering: Unit respons terukur.
  • Estimasi referensi per permintaan: USD 0.124425.
  • Dasar biaya unit: USD 0.004977.
  • Unit sumber daya: similar_creator_point.
  • Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.
  • Dasar biaya tidak menentukan harga pelanggan akhir, termasuk saat bernilai nol.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi
wajib
application/json
  • target_account
    Tipe: string
    wajib

    Akun seed: handle kreator (dengan atau tanpa @) atau URL profil untuk menemukan kreator serupa.

  • filters
    Tipe: object

    Filter opsional yang diterapkan sebelum pencocokan. Semua field opsional.

    • creatorTypes
      Tipe: array string[]

      Jenis akun kreator, misalnya ["individual", "brand"].

    • ethnicities
      Tipe: array string[]

      Etnis kreator yang disimpulkan.

    • faceVisibilities
      Tipe: array string[]

      Klasifikasi visibilitas wajah, misalnya ["clear_face", "mixed", "no_face"].

    • genders
      Tipe: array string[]

      Gender kreator yang disimpulkan, misalnya ["female", "male"].

    • languages
      Tipe: array string[]

      Bahasa kreator, misalnya ["en", "ja", "zh-cn"].

    • maxFollowers
      Tipe: number

      Jumlah pengikut / pelanggan maksimum.

    • maxPlayCount
      Tipe: number

      Jumlah pemutaran / penayangan maksimum, diukur dengan playCountMetric.

    • minFollowers
      Tipe: number

      Jumlah pengikut / pelanggan minimum.

    • minPlayCount
      Tipe: number

      Jumlah pemutaran / penayangan minimum, diukur dengan playCountMetric.

    • playCountMetric
      Tipe: string enum

      Apakah minPlayCount / maxPlayCount dibandingkan dengan median atau rata-rata jumlah pemutaran.

      nilai
      • median
      • average
    • regions
      Tipe: array string[]

      Wilayah kreator (kode negara ISO), misalnya ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Tipe: boolean

      Saat bernilai true, kreator yang sudah disimpan di ruang kerja Anda dikecualikan dari hasil.

  • limit
    Tipe: integer
    min:  
    1
    maks:  
    100

    Integer numbers.

  • platform
    Tipe: string enum
    nilai
    • instagram
    • tiktok
    • youtube
Respons
  • 200
    Tipe: object

    Kreator serupa dikembalikan.

    • billingRequestId
      Tipe: string

      Referensi penagihan penyedia, bukan tanda terima penagihan Felo.

    • data
      Tipe: object · ResponseEb32A34A5274_CreatorSearchData
      • count
        Tipe: number

        Jumlah kreator yang dikirimkan. Penagihan didasarkan pada jumlah yang dikirimkan ini.

      • items
        Tipe: array object[] · ResponseEb32A34A5274_Creator[]

        Kreator yang cocok, diurutkan berdasarkan score menurun.

        Kreator yang cocok. Field konsisten di Similar Creators dan AI Search.

        • accountPositioning
          Tipe: array string[]

          Tag pendek yang dihasilkan AI, merangkum niche / posisi kreator.

        • ageRange
          Tipe: string

          Rentang usia yang disimpulkan (misalnya 25_34), atau unknown.

        • aiDescription
          Tipe: string

          Ringkasan yang dihasilkan AI tentang konten, gaya, dan visual khas kreator.

        • averageEngagementRate
          Tipe: number

          Rata-rata tingkat interaksi (0–1).

        • averagePlayCount
          Tipe: number

          Rata-rata jumlah pemutaran / tayangan di postingan terbaru.

        • biography
          Tipe: string

          Teks bio profil.

        • email
          Tipe: string | null

          Email kontak yang diekstrak dari profil, jika tersedia.

        • ethnicity
          Tipe: string

          Etnis yang disimpulkan, atau unknown.

        • faceVisibility
          Tipe: string

          Klasifikasi visibilitas wajah, misalnya clear_face, mixed, no_face.

        • followerCount
          Tipe: number

          Jumlah pengikut / pelanggan.

        • fullName
          Tipe: string

          Nama tampilan kreator.

        • gender
          Tipe: string

          Jenis kelamin yang disimpulkan, atau unknown.

        • id
          Tipe: string

          ID kreator di sisi platform.

        • language
          Tipe: string

          Bahasa konten utama.

        • medianEngagementRate
          Tipe: number

          Tingkat engagement median (0–1).

        • medianPlayCount
          Tipe: number

          Median jumlah pemutaran / penayangan di seluruh postingan terbaru.

        • platform
          Tipe: string

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

        • profileUrl
          Tipe: string

          URL profil kreator.

        • region
          Tipe: string

          Wilayah kreator (kode negara ISO).

        • score
          Tipe: number

          Skor relevansi kecocokan (0–1), diurutkan menurun.

        • username
          Tipe: string

          Handle kreator (tanpa @ di awal).

    • requestId
      Tipe: string

      ID permintaan untuk dukungan dan pemantauan.

    application/json
  • 400

    Permintaan tidak dapat diproses. Periksa parameter permintaan.

  • 401

    Kunci API Felo yang valid diperlukan.

  • 402

    Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.

  • 403

    Akun tidak diizinkan melakukan operasi ini.

  • 429

    Batas permintaan atau batas pengeluaran telah tercapai.

  • 502

    Layanan tidak dapat menyelesaikan permintaan.

  • 503

    API atau layanan penagihan untuk sementara tidak tersedia.

  • 504

    Layanan kehabisan waktu saat memproses permintaan.

  • default

    Respons error; respons passthrough upstream dapat menggunakan format penyedia

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

Kreator serupa dikembalikan.

Similar Creators