Felo API PlatformFelo API Platform
Tutti gli endpoint di Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

Creator simili

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

Creator Data

​

Creator discovery and public contact information.

Creator Data Operazioni

Creator simili

​

Trova creator simili usando il target_account obbligatorio. platform è facoltativo, il valore predefinito è youtube, e supporta instagram, tiktok e youtube. Segui i filtri documentati per restringere i risultati. billingRequestId è un riferimento del provider, non una ricevuta di fatturazione Felo.

Riferimento prezzi

  • Misurazione: unità di risposta misurate.
  • Stima di riferimento per richiesta: USD 0.124425.
  • Base di costo unitario: USD 0.004977.
  • Unità di risorsa: similar_creator_point.
  • Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
  • Le basi di costo non determinano il prezzo finale per il cliente, anche quando sono zero.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo
obbligatorio
application/json
  • target_account
    Tipo: string
    obbligatorio

    Account seed: un handle di creator (con o senza @) o un URL del profilo per cui trovare creator simili.

  • filters
    Tipo: object

    Filtri facoltativi applicati prima della corrispondenza. Tutti i campi sono facoltativi.

    • creatorTypes
      Tipo: array string[]

      Tipi di account dei creator, ad es. ["individual", "brand"].

    • ethnicities
      Tipo: array string[]

      Etnie dei creator dedotte.

    • faceVisibilities
      Tipo: array string[]

      Classificazioni della visibilità del volto, ad es. ["clear_face", "mixed", "no_face"].

    • genders
      Tipo: array string[]

      Generi dei creator dedotti, ad es. ["female", "male"].

    • languages
      Tipo: array string[]

      Lingue dei creator, ad es. ["en", "ja", "zh-cn"].

    • maxFollowers
      Tipo: number

      Numero massimo di follower / iscritti.

    • maxPlayCount
      Tipo: number

      Numero massimo di riproduzioni / visualizzazioni, misurato da playCountMetric.

    • minFollowers
      Tipo: number

      Numero minimo di follower / iscritti.

    • minPlayCount
      Tipo: number

      Numero minimo di riproduzioni / visualizzazioni, misurato da playCountMetric.

    • playCountMetric
      Tipo: string enum

      Se minPlayCount / maxPlayCount vengono confrontati con la mediana o con il numero medio di riproduzioni.

      valori
      • median
      • average
    • regions
      Tipo: array string[]

      Regioni dei creator (codici paese ISO), ad es. ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Tipo: boolean

      Se true, i creator già salvati nel tuo workspace vengono esclusi dai risultati.

  • limit
    Tipo: integer
    min:  
    1
    max:  
    100

    Integer numbers.

  • platform
    Tipo: string enum
    valori
    • instagram
    • tiktok
    • youtube
Risposte
  • 200
    Tipo: object

    Creator simili restituiti

    • billingRequestId
      Tipo: string

      Riferimento di fatturazione del provider, non una ricevuta di fatturazione Felo.

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

        Numero di creator forniti. La fatturazione si basa su questo numero di elementi forniti.

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

        Creator corrispondenti, ordinati per score in modo decrescente.

        Un creator corrispondente. I campi sono coerenti tra Similar Creators e AI Search.

        • accountPositioning
          Tipo: array string[]

          Tag brevi generati dall'IA che riassumono la nicchia/il posizionamento del creator.

        • ageRange
          Tipo: string

          Fascia d'età dedotta (ad es. 25_34), oppure unknown.

        • aiDescription
          Tipo: string

          Riepilogo generato dall'IA dei contenuti, dello stile e degli elementi visivi tipici del creator.

        • averageEngagementRate
          Tipo: number

          Tasso di engagement medio (0–1).

        • averagePlayCount
          Tipo: number

          Numero medio di play/visualizzazioni sui post recenti.

        • biography
          Tipo: string

          Testo della biografia del profilo.

        • email
          Tipo: string | null

          Email di contatto estratta dal profilo, quando disponibile.

        • ethnicity
          Tipo: string

          Etnia dedotta, oppure unknown.

        • faceVisibility
          Tipo: string

          Classificazione della visibilità del volto, ad es. clear_face, mixed, no_face.

        • followerCount
          Tipo: number

          Numero di follower/iscritti.

        • fullName
          Tipo: string

          Nome visualizzato del creator.

        • gender
          Tipo: string

          Genere dedotto, oppure unknown.

        • id
          Tipo: string

          ID del creator lato piattaforma.

        • language
          Tipo: string

          Lingua principale dei contenuti.

        • medianEngagementRate
          Tipo: number

          Tasso di engagement mediano (0–1).

        • medianPlayCount
          Tipo: number

          Numero mediano di riproduzioni / visualizzazioni sui post recenti.

        • platform
          Tipo: string

          Piattaforma di appartenenza del creator: instagram, tiktok o youtube.

        • profileUrl
          Tipo: string

          URL del profilo del creator.

        • region
          Tipo: string

          Regione del creator (codice paese ISO).

        • score
          Tipo: number

          Punteggio di rilevanza della corrispondenza (0–1), ordinato in modo decrescente.

        • username
          Tipo: string

          Handle del creator (senza la @ iniziale).

    • requestId
      Tipo: string

      ID della richiesta per assistenza e monitoraggio.

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

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

Creator simili restituiti

Similar Creators