Felo API PlatformFelo API Platform
Alle endpoints van Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

Vergelijkbare creators

Felo API Support
MIT
Server:https://openapi.felo.ai
Clientbibliotheken
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data Operaties

Vergelijkbare creators

​

Vindt vergelijkbare creators met de verplichte target_account. platform is optioneel, standaard youtube, en ondersteunt instagram, tiktok en youtube. Volg de gedocumenteerde filters om de resultaten te verfijnen. billingRequestId is een referentie van de provider, geen Felo-factureringsbewijs.

Prijsreferentie

  • Metering: Gemeten responseenheden.
  • Referentieschatting per verzoek: USD 0.124425.
  • Kostenbasis per eenheid: USD 0.004977.
  • Resource-eenheid: similar_creator_point.
  • Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.
  • Kostenbases bepalen niet de uiteindelijke klantprijs, ook niet wanneer die nul is.

Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.

Body
verplicht
application/json
  • target_account
    Type: string
    verplicht

    Seed-account: een creatorhandle (met of zonder @) of profiel-URL waarvoor vergelijkbare creators moeten worden gevonden.

  • filters
    Type: object

    Optionele filters die vóór het matchen worden toegepast. Alle velden zijn optioneel.

    • creatorTypes
      Type: array string[]

      Accounttypen van creators, bijvoorbeeld ["individual", "brand"].

    • ethnicities
      Type: array string[]

      Afgeleide etniciteiten van creators.

    • faceVisibilities
      Type: array string[]

      Classificaties voor zichtbaarheid van het gezicht, bijvoorbeeld ["clear_face", "mixed", "no_face"].

    • genders
      Type: array string[]

      Afgeleide geslachten van creators, bijvoorbeeld ["female", "male"].

    • languages
      Type: array string[]

      Talen van creators, bijvoorbeeld ["en", "ja", "zh-cn"].

    • maxFollowers
      Type: number

      Maximaal aantal volgers / abonnees.

    • maxPlayCount
      Type: number

      Maximaal aantal weergaven / views, gemeten via playCountMetric.

    • minFollowers
      Type: number

      Minimaal aantal volgers / abonnees.

    • minPlayCount
      Type: number

      Minimaal aantal weergaven / views, gemeten via playCountMetric.

    • playCountMetric
      Type: string enum

      Of minPlayCount / maxPlayCount worden vergeleken met de mediaan of het gemiddelde aantal weergaven.

      waarden
      • median
      • average
    • regions
      Type: array string[]

      Regio's van creators (ISO-landcodes), bijvoorbeeld ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Type: boolean

      Wanneer true, worden creators die al in je werkruimte zijn opgeslagen uitgesloten van de resultaten.

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

    Integer numbers.

  • platform
    Type: string enum
    waarden
    • instagram
    • tiktok
    • youtube
Responsen
  • 200
    Type: object

    Vergelijkbare creators geretourneerd

    • billingRequestId
      Type: string

      Factureringsreferentie van de aanbieder, geen Felo-factureringsbewijs.

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

        Aantal geleverde creators. De facturering is gebaseerd op dit geleverde aantal.

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

        Gematchte creators, aflopend gesorteerd op score.

        Een gematchte creator. De velden zijn consistent tussen Similar Creators en AI Search.

        • accountPositioning
          Type: array string[]

          Korte door AI gegenereerde tags die de niche/positionering van de creator samenvatten.

        • ageRange
          Type: string

          Afgeleide leeftijdscategorie (bijv. 25_34), of unknown.

        • aiDescription
          Type: string

          Door AI gegenereerde samenvatting van de inhoud, stijl en typische visuals van de creator.

        • averageEngagementRate
          Type: number

          Gemiddelde engagementratio (0–1).

        • averagePlayCount
          Type: number

          Gemiddeld aantal plays/weergaven over recente posts.

        • biography
          Type: string

          Biografietekst van het profiel.

        • email
          Type: string | null

          Uit het profiel geëxtraheerd contact-e-mailadres, indien beschikbaar.

        • ethnicity
          Type: string

          Afgeleide etniciteit, of unknown.

        • faceVisibility
          Type: string

          Classificatie van gezichtszichtbaarheid, bijv. clear_face, mixed, no_face.

        • followerCount
          Type: number

          Aantal volgers/abonnees.

        • fullName
          Type: string

          Weergavenaam van de creator.

        • gender
          Type: string

          Afgeleid geslacht, of unknown.

        • id
          Type: string

          Creator-ID aan de platformzijde.

        • language
          Type: string

          Primaire inhoudstaal.

        • medianEngagementRate
          Type: number

          Mediane engagementratio (0–1).

        • medianPlayCount
          Type: number

          Mediaan van het aantal weergaven / plays over recente berichten.

        • platform
          Type: string

          Platform waarbij deze creator hoort: instagram, tiktok of youtube.

        • profileUrl
          Type: string

          Profiel-URL van de creator.

        • region
          Type: string

          Regio van de creator (ISO-landcode).

        • score
          Type: number

          Relevantiescore van de match (0–1), aflopend gesorteerd.

        • username
          Type: string

          Handle van de creator (zonder het voorafgaande @).

    • requestId
      Type: string

      Verzoek-ID voor ondersteuning en monitoring.

    application/json
  • 400

    Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.

  • 401

    Een geldige Felo-API-sleutel is vereist.

  • 402

    Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.

  • 403

    Het account mag deze bewerking niet uitvoeren.

  • 429

    Een verzoek- of bestedingslimiet is bereikt.

  • 502

    De dienst kon het verzoek niet voltooien.

  • 503

    De API of factureringsdienst is tijdelijk niet beschikbaar.

  • 504

    Er is een time-out opgetreden bij het verwerken van het verzoek.

  • default

    Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken

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

Vergelijkbare creators geretourneerd

Similar Creators