Felo API PlatformFelo API Platform
सभी Creator Discovery endpoint
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 बिलिंग रसीद नहीं।

मूल्य संदर्भ

  • मीटरिंग: मीटर की गई response यूनिट
  • संदर्भ request अनुमान: 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

      अधिकतम play / view संख्या, जिसे playCountMetric से मापा जाता है।

    • minFollowers
      टाइप: number

      न्यूनतम फ़ॉलोअर / सब्सक्राइबर संख्या।

    • minPlayCount
      टाइप: number

      न्यूनतम play / view संख्या, जिसे playCountMetric से मापा जाता है।

    • playCountMetric
      टाइप: string enum

      क्या minPlayCount / maxPlayCount की तुलना माध्यिका या औसत play संख्या से की जाती है।

      मान
      • median
      • average
    • regions
      टाइप: array string[]

      क्रिएटर क्षेत्र (ISO देश कोड), जैसे ["US", "GB", "JP"]।

    • workspaceDeduplicationEnabled
      टाइप: boolean

      true होने पर, आपके workspace में पहले से सहेजे गए क्रिएटर परिणामों से बाहर रखे जाते हैं।

  • limit
    टाइप: integer
    न्यूनतम:  
    1
    अधिकतम:  
    100

    Integer numbers.

  • platform
    टाइप: string enum
    मान
    • instagram
    • tiktok
    • youtube
responses
  • 200
    टाइप: object

    समान क्रिएटर सफलतापूर्वक लौटाए गए।

    • billingRequestId
      टाइप: string

      प्रोवाइडर बिलिंग संदर्भ, Felo बिलिंग रसीद नहीं।

    • data
      टाइप: object · ResponseEb32A34A5274_CreatorSearchData
      • count
        टाइप: number

        डिलीवर किए गए क्रिएटर की संख्या। बिलिंग इस डिलीवर की गई संख्या पर आधारित होती है।

      • items
        टाइप: array object[] · ResponseEb32A34A5274_Creator[]

        मिलान किए गए क्रिएटर, score के अनुसार अवरोही क्रम में क्रमबद्ध

        एक मिलान किया गया क्रिएटर। Similar Creators और AI Search में फ़ील्ड एक जैसी रहती हैं।

        • accountPositioning
          टाइप: array string[]

          क्रिएटर के niche / positioning को सारांशित करने वाले छोटे AI-जनरेट किए गए टैग।

        • ageRange
          टाइप: string

          अनुमानित आयु सीमा (जैसे 25_34), या unknown।

        • aiDescription
          टाइप: string

          क्रिएटर की सामग्री, शैली और सामान्य दृश्यों का AI-जनरेट किया गया सारांश।

        • averageEngagementRate
          टाइप: number

          औसत सहभागिता दर (0–1)।

        • averagePlayCount
          टाइप: number

          हाल के पोस्टों में औसत play / view संख्या।

        • 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

    request संसाधित नहीं किया जा सका। request पैरामीटर जाँचें।

  • 401

    एक वैध Felo API key आवश्यक है।

  • 402

    request आगे नहीं बढ़ सकता क्योंकि बिलिंग आवश्यकता पूरी नहीं हुई है।

  • 403

    खाते को यह ऑपरेशन करने की अनुमति नहीं है।

  • 429

    request या खर्च की सीमा तक पहुँच गए हैं।

  • 502

    सेवा request पूरा नहीं कर सकी।

  • 503

    API या बिलिंग सेवा अस्थायी रूप से उपलब्ध नहीं है।

  • 504

    request संसाधित करते समय सेवा का समय समाप्त हो गया।

  • default

    त्रुटि response; upstream passthrough response प्रोवाइडर फ़ॉर्मेट का उपयोग कर सकते हैं।

    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