Felo API PlatformFelo API Platform
Wszystkie endpointy Creator Discovery
v0.2.0-beta
OpenAPI 3.1.0

Podobni twórcy

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

Creator Data

​

Creator discovery and public contact information.

Creator Data Operacje

Podobni twórcy

​

Znajduje podobnych twórców za pomocą wymaganego target_account. platform jest opcjonalne, domyślnie przyjmuje youtube i obsługuje instagram, tiktok oraz youtube. Użyj udokumentowanych filtrów, aby zawęzić wyniki. billingRequestId to referencja dostawcy, a nie potwierdzenie rozliczenia Felo.

Cennik referencyjny

  • Rozliczanie: naliczone jednostki odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.124425.
  • Podstawa kosztu jednostkowego: USD 0.004977.
  • Jednostka zasobu: similar_creator_point.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
  • Podstawy kosztu nie ustalają ostatecznej ceny dla klienta, również gdy wynoszą zero.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
wymagane
application/json
  • target_account
    Typ: string
    wymagane

    Konto źródłowe: nazwa twórcy (z @ lub bez) albo adres URL profilu, dla którego mają zostać znalezieni podobni twórcy.

  • filters
    Typ: object

    Opcjonalne filtry stosowane przed dopasowaniem. Wszystkie pola są opcjonalne.

    • creatorTypes
      Typ: array string[]

      Typy kont twórców, np. ["individual", "brand"].

    • ethnicities
      Typ: array string[]

      Wnioskowane pochodzenie etniczne twórców.

    • faceVisibilities
      Typ: array string[]

      Klasyfikacje widoczności twarzy, np. ["clear_face", "mixed", "no_face"].

    • genders
      Typ: array string[]

      Wnioskowane płcie twórców, np. ["female", "male"].

    • languages
      Typ: array string[]

      Języki twórców, np. ["en", "ja", "zh-cn"].

    • maxFollowers
      Typ: number

      Maksymalna liczba obserwujących / subskrybentów.

    • maxPlayCount
      Typ: number

      Maksymalna liczba odtworzeń / wyświetleń, mierzona przez playCountMetric.

    • minFollowers
      Typ: number

      Minimalna liczba obserwujących / subskrybentów.

    • minPlayCount
      Typ: number

      Minimalna liczba odtworzeń / wyświetleń, mierzona przez playCountMetric.

    • playCountMetric
      Typ: string enum

      Czy minPlayCount / maxPlayCount są porównywane z medianą, czy ze średnią liczbą odtworzeń.

      wartości
      • median
      • average
    • regions
      Typ: array string[]

      Regiony twórców (kody krajów ISO), np. ["US", "GB", "JP"].

    • workspaceDeduplicationEnabled
      Typ: boolean

      Gdy true, twórcy zapisani już w Twoim obszarze roboczym są wykluczani z wyników.

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

    Integer numbers.

  • platform
    Typ: string enum
    wartości
    • instagram
    • tiktok
    • youtube
Odpowiedzi
  • 200
    Typ: object

    Zwrócono podobnych twórców

    • billingRequestId
      Typ: string

      Referencja rozliczeniowa dostawcy, a nie potwierdzenie rozliczenia Felo.

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

        Liczba dostarczonych twórców. Rozliczenie opiera się na tej dostarczonej liczbie.

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

        Dopasowani twórcy, posortowani malejąco według score.

        Dopasowany twórca. Pola są spójne w Similar Creators i AI Search.

        • accountPositioning
          Typ: array string[]

          Krótkie tagi generowane przez AI, podsumowujące niszę / pozycjonowanie twórcy.

        • ageRange
          Typ: string

          Wnioskowany przedział wiekowy (np. 25_34) lub unknown.

        • aiDescription
          Typ: string

          Podsumowanie treści, stylu i typowych materiałów wizualnych twórcy wygenerowane przez AI.

        • averageEngagementRate
          Typ: number

          Średni współczynnik zaangażowania (0–1).

        • averagePlayCount
          Typ: number

          Średnia liczba odtworzeń / wyświetleń w ostatnich postach.

        • biography
          Typ: string

          Tekst bio profilu.

        • email
          Typ: string | null

          E-mail kontaktowy wyodrębniony z profilu, jeśli dostępny.

        • ethnicity
          Typ: string

          Wnioskowane pochodzenie etniczne lub unknown.

        • faceVisibility
          Typ: string

          Klasyfikacja widoczności twarzy, np. clear_face, mixed, no_face.

        • followerCount
          Typ: number

          Liczba obserwujących / subskrybentów.

        • fullName
          Typ: string

          Wyświetlana nazwa twórcy.

        • gender
          Typ: string

          Wnioskowana płeć lub unknown.

        • id
          Typ: string

          Identyfikator twórcy po stronie platformy.

        • language
          Typ: string

          Główny język treści.

        • medianEngagementRate
          Typ: number

          Mediana wskaźnika zaangażowania (0–1).

        • medianPlayCount
          Typ: number

          Mediana liczby odtworzeń / wyświetleń w ostatnich postach.

        • platform
          Typ: string

          Platforma, do której należy ten twórca: instagram, tiktok lub youtube.

        • profileUrl
          Typ: string

          Adres URL profilu twórcy.

        • region
          Typ: string

          Region twórcy (kod kraju ISO).

        • score
          Typ: number

          Wynik trafności dopasowania (0–1), sortowanie malejące.

        • username
          Typ: string

          Nazwa użytkownika twórcy (bez wiodącego @).

    • requestId
      Typ: string

      Identyfikator żądania do celów pomocy technicznej i monitorowania.

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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

Zwrócono podobnych twórców

Similar Creators