Felo API PlatformFelo API Platform
Alle Endpoints von Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

Ähnliche Creator

Felo API Support
MIT
Server:https://openapi.felo.ai
Client-Bibliotheken
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data Operationen

Ähnliche Creator

​

Findet ähnliche Creator anhand des erforderlichen target_account. platform ist optional, standardmäßig youtube, und unterstützt instagram, tiktok und youtube. Befolgen Sie die dokumentierten Filter, um die Ergebnisse einzugrenzen. billingRequestId ist eine Anbieterreferenz, kein Felo-Abrechnungsbeleg.

Preisreferenz

  • Abrechnung: Abrechnete Antworteinheiten.
  • Referenzschätzung pro Anfrage: USD 0.124425.
  • Kostenbasis pro Einheit: USD 0.004977.
  • Ressourceneinheit: similar_creator_point.
  • Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf bereits abgerechnete Kundenbeträge anwenden.
  • Kostenbasen legen den endgültigen Kundenpreis nicht fest, auch nicht bei null.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body
erforderlich
application/json
  • target_account
    Typ: string
    erforderlich

    Seed-Konto: ein Creator-Handle (mit oder ohne @) oder eine Profil-URL, für die ähnliche Creator gefunden werden sollen.

  • filters
    Typ: object

    Optionale Filter, die vor dem Abgleich angewendet werden. Alle Felder sind optional.

    • creatorTypes
      Typ: array string[]

      Kontoarten der Creator, z. B. ["individual", "brand"].

    • ethnicities
      Typ: array string[]

      Abgeleitete Ethnien der Creator.

    • faceVisibilities
      Typ: array string[]

      Klassifikationen der Gesichtssichtbarkeit, z. B. ["clear_face", "mixed", "no_face"].

    • genders
      Typ: array string[]

      Abgeleitete Geschlechter der Creator, z. B. ["female", "male"].

    • languages
      Typ: array string[]

      Sprachen der Creator, z. B. ["en", "ja", "zh-cn"].

    • maxFollowers
      Typ: number

      Maximale Anzahl an Followern / Abonnenten.

    • maxPlayCount
      Typ: number

      Maximale Wiedergabe- / Aufrufanzahl, gemessen an playCountMetric.

    • minFollowers
      Typ: number

      Minimale Anzahl an Followern / Abonnenten.

    • minPlayCount
      Typ: number

      Minimale Wiedergabe- / Aufrufanzahl, gemessen an playCountMetric.

    • playCountMetric
      Typ: string enum

      Ob minPlayCount / maxPlayCount mit dem Median oder dem durchschnittlichen Wiedergabewert verglichen werden.

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

      Regionen der Creator (ISO-Ländercodes), z. B. ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Typ: boolean

      Wenn true, werden Creator, die bereits in Ihrem Workspace gespeichert sind, aus den Ergebnissen ausgeschlossen.

  • limit
    Typ: integer
    min.:  
    1
    max.:  
    100

    Integer numbers.

  • platform
    Typ: string enum
    Werte
    • instagram
    • tiktok
    • youtube
Antworten
  • 200
    Typ: object

    Ähnliche Creator zurückgegeben

    • billingRequestId
      Typ: string

      Abrechnungsreferenz des Anbieters, kein Felo-Abrechnungsbeleg.

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

        Anzahl der gelieferten Creators. Die Abrechnung basiert auf dieser gelieferten Anzahl.

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

        Übereinstimmende Creators, absteigend nach score sortiert.

        Ein passender Creator. Die Felder sind über Similar Creators und AI Search hinweg konsistent.

        • accountPositioning
          Typ: array string[]

          Kurze KI-generierte Tags, die die Nische bzw. Positionierung des Creators zusammenfassen.

        • ageRange
          Typ: string

          Abgeleitete Altersspanne (z. B. 25_34) oder unknown.

        • aiDescription
          Typ: string

          KI-generierte Zusammenfassung der Inhalte, des Stils und der typischen Visuals des Creators.

        • averageEngagementRate
          Typ: number

          Durchschnittliche Engagement-Rate (0–1).

        • averagePlayCount
          Typ: number

          Durchschnittliche Play-/Aufrufzahl über die letzten Beiträge.

        • biography
          Typ: string

          Biografietext des Profils.

        • email
          Typ: string | null

          Aus dem Profil extrahierte Kontakt-E-Mail, sofern verfügbar.

        • ethnicity
          Typ: string

          Abgeleitete ethnische Zugehörigkeit oder unknown.

        • faceVisibility
          Typ: string

          Klassifizierung der Gesichtssichtbarkeit, z. B. clear_face, mixed, no_face.

        • followerCount
          Typ: number

          Anzahl der Follower bzw. Abonnenten.

        • fullName
          Typ: string

          Anzeigename des Creators.

        • gender
          Typ: string

          Abgeleitetes Geschlecht oder unknown.

        • id
          Typ: string

          Creator-ID der Plattform.

        • language
          Typ: string

          Hauptsprache der Inhalte.

        • medianEngagementRate
          Typ: number

          Mediane Engagement-Rate (0–1).

        • medianPlayCount
          Typ: number

          Median der Wiedergabe-/Aufrufzahlen über die letzten Beiträge.

        • platform
          Typ: string

          Plattform, zu der dieser Creator gehört: instagram, tiktok oder youtube.

        • profileUrl
          Typ: string

          Profil-URL des Creators.

        • region
          Typ: string

          Region des Creators (ISO-Ländercode).

        • score
          Typ: number

          Relevanzwert der Übereinstimmung (0–1), absteigend sortiert.

        • username
          Typ: string

          Creator-Handle (ohne führendes @).

    • requestId
      Typ: string

      Anfrage-ID für Support und Monitoring.

    application/json
  • 400

    Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.

  • 401

    Ein gültiger Felo-API-Schlüssel ist erforderlich.

  • 402

    Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.

  • 403

    Das Konto ist für diesen Vorgang nicht berechtigt.

  • 429

    Ein Anfrage- oder Ausgabenlimit wurde erreicht.

  • 502

    Der Dienst konnte die Anfrage nicht abschließen.

  • 503

    Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.

  • 504

    Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.

  • default

    Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

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

Ähnliche Creator zurückgegeben

Similar Creators