Felo API PlatformFelo API Platform
تمام Creator Discovery endpoints
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 آپریشنز

ملتے جلتے تخلیق کار

​

درکار 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
    لازمی

    seed اکاؤنٹ: ایک تخلیق کار کا ہینڈل (@ کے ساتھ یا اس کے بغیر) یا پروفائل 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

          پلیٹ فارم کی طرف کا تخلیق کار 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

    درست Felo API کلید درکار ہے۔

  • 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