Felo API PlatformFelo API Platform
Všechny endpointy Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

Podobní tvůrci

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data Operace

Podobní tvůrci

​

Vyhledává podobné tvůrce pomocí povinného target_account. platform je volitelné, ve výchozím nastavení youtube a podporuje instagram, tiktok a youtube. Výsledky zužte pomocí dokumentovaných filtrů. billingRequestId je reference poskytovatele, nikoli potvrzení o fakturaci Felo.

Cenová reference

  • Účtování: měřené jednotky odpovědi.
  • Referenční odhad požadavku: USD 0.124425.
  • Základ jednotkových nákladů: USD 0.004977.
  • Jednotka prostředku: similar_creator_point.
  • Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.
  • Nákladové základny neurčují konečnou cenu pro zákazníka, a to ani když jsou nulové.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
povinné
application/json
  • target_account
    Typ: string
    povinné

    Počáteční účet: handle tvůrce (s @ nebo bez) nebo adresa URL profilu, pro který se mají najít podobní tvůrci.

  • filters
    Typ: object

    Volitelné filtry použité před párováním. Všechna pole jsou volitelná.

    • creatorTypes
      Typ: array string[]

      Typy tvůrčích účtů, např. ["individual", "brand"].

    • ethnicities
      Typ: array string[]

      Odvozené etnické příslušnosti tvůrců.

    • faceVisibilities
      Typ: array string[]

      Klasifikace viditelnosti tváře, např. ["clear_face", "mixed", "no_face"].

    • genders
      Typ: array string[]

      Odvozená pohlaví tvůrců, např. ["female", "male"].

    • languages
      Typ: array string[]

      Jazyky tvůrců, např. ["en", "ja", "zh-cn"].

    • maxFollowers
      Typ: number

      Maximální počet sledujících / odběratelů.

    • maxPlayCount
      Typ: number

      Maximální počet přehrání / zobrazení, měřeno pomocí playCountMetric.

    • minFollowers
      Typ: number

      Minimální počet sledujících / odběratelů.

    • minPlayCount
      Typ: number

      Minimální počet přehrání / zobrazení, měřeno pomocí playCountMetric.

    • playCountMetric
      Typ: string enum

      Zda se minPlayCount / maxPlayCount porovnávají s mediánem, nebo s průměrným počtem přehrání.

      hodnoty
      • median
      • average
    • regions
      Typ: array string[]

      Regiony tvůrců (kódy zemí ISO), např. ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Typ: boolean

      Když je true, tvůrci již uložení ve vašem pracovním prostoru se z výsledků vyloučí.

  • limit
    Typ: integer
    min:  
    1
    max:  
    100

    Integer numbers.

  • platform
    Typ: string enum
    hodnoty
    • instagram
    • tiktok
    • youtube
Odpovědi
  • 200
    Typ: object

    Vráceni podobní tvůrci

    • billingRequestId
      Typ: string

      Fakturační reference poskytovatele, nikoli fakturační potvrzení Felo.

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

        Počet doručených tvůrců. Fakturace vychází z tohoto doručeného počtu.

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

        Odpovídající tvůrci, seřazeno sestupně podle score.

        Odpovídající tvůrce. Pole jsou shodná napříč Similar Creators a AI Search.

        • accountPositioning
          Typ: array string[]

          Krátké tagy generované AI shrnující niku / positioning tvůrce.

        • ageRange
          Typ: string

          Odvozené věkové rozpětí (např. 25_34) nebo unknown.

        • aiDescription
          Typ: string

          Souhrn obsahu, stylu a typických vizuálů tvůrce generovaný AI.

        • averageEngagementRate
          Typ: number

          Průměrná míra zapojení (0–1).

        • averagePlayCount
          Typ: number

          Průměrný počet přehrání / zhlédnutí u nedávných příspěvků.

        • biography
          Typ: string

          Text bio profilu.

        • email
          Typ: string | null

          Kontaktní e-mail extrahovaný z profilu, pokud je k dispozici.

        • ethnicity
          Typ: string

          Odvozený etnický původ nebo unknown.

        • faceVisibility
          Typ: string

          Klasifikace viditelnosti obličeje, např. clear_face, mixed, no_face.

        • followerCount
          Typ: number

          Počet sledujících / odběratelů.

        • fullName
          Typ: string

          Zobrazovaný název tvůrce.

        • gender
          Typ: string

          Odvozené pohlaví, nebo unknown.

        • id
          Typ: string

          ID tvůrce na straně platformy.

        • language
          Typ: string

          Primární jazyk obsahu.

        • medianEngagementRate
          Typ: number

          Medián míry zapojení (0–1).

        • medianPlayCount
          Typ: number

          Medián počtu přehrání / zhlédnutí u nedávných příspěvků.

        • platform
          Typ: string

          Platforma, ke které tento tvůrce patří: instagram, tiktok nebo youtube.

        • profileUrl
          Typ: string

          URL profilu tvůrce.

        • region
          Typ: string

          Region tvůrce (kód země ISO).

        • score
          Typ: number

          Skóre relevance shody (0–1), seřazeno sestupně.

        • username
          Typ: string

          Uživatelské jméno tvůrce (bez úvodního @).

    • requestId
      Typ: string

      ID požadavku pro podporu a monitorování.

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

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

Vráceni podobní tvůrci

Similar Creators