Felo API PlatformFelo API Platform
endpoint ทั้งหมดของ Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

ครีเอเตอร์ที่คล้ายกัน

เซิร์ฟเวอร์:https://openapi.felo.ai
ไลบรารีไคลเอนต์

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[]

          แท็กสั้นที่สร้างโดย AI ซึ่งสรุปกลุ่มเฉพาะ/จุดยืนของครีเอเตอร์

        • ageRange
          ประเภท: string

          ช่วงอายุที่อนุมานได้ (เช่น 25_34) หรือ unknown

        • aiDescription
          ประเภท: string

          สรุปเนื้อหา สไตล์ และภาพลักษณ์ทั่วไปของครีเอเตอร์ที่สร้างโดย AI

        • averageEngagementRate
          ประเภท: number

          อัตราการมีส่วนร่วมเฉลี่ย (0–1)

        • averagePlayCount
          ประเภท: number

          จำนวนการเล่น/รับชมเฉลี่ยจากโพสต์ล่าสุด

        • biography
          ประเภท: string

          ข้อความ bio ของโปรไฟล์

        • 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

      Request ID สำหรับการสนับสนุนและการตรวจสอบ

    application/json
  • 400

    ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ

  • 401

    จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง

  • 402

    ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน

  • 403

    บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้

  • 429

    ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว

  • 502

    บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้

  • 503

    API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว

  • 504

    บริการหมดเวลาระหว่างประมวลผลคำขอ

  • default

    การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

    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