Felo API PlatformFelo API Platform
כל ה-endpoints של 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.

מראה תמחור

  • מדידה: יחידות תגובה נמדדות.
  • אומדן בקשת ייחוס: 0.124425 דולר ארה״ב.
  • בסיס עלות יחידה: 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

          טקסט הביו של הפרופיל.

        • email
          סוג: string | null

          כתובת דוא"ל ליצירת קשר שחולצה מהפרופיל, כאשר זמינה.

        • ethnicity
          סוג: string

          מוצא אתני מוסק, או unknown.

        • faceVisibility
          סוג: string

          סיווג נראות הפנים, למשל clear_face, mixed, no_face.

        • followerCount
          סוג: number

          מספר העוקבים / המנויים.

        • fullName
          סוג: string

          שם התצוגה של היוצר.

        • gender
          סוג: string

          מין שהוסק, או unknown.

        • id
          סוג: string

          מזהה יוצר בצד הפלטפורמה.

        • 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

      מזהה בקשה לתמיכה ולניטור.

    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