Creator Data
Creator discovery and public contact information.
Créateurs similaires
Trouve des créateurs similaires à partir du target_account obligatoire. platform est facultatif, vaut youtube par défaut et accepte instagram, tiktok et youtube. Suivez les filtres documentés pour affiner les résultats. billingRequestId est une référence du fournisseur, pas un reçu de facturation Felo.
Référence tarifaire
- Mesure : unités de réponse mesurées.
- Estimation de référence par requête : USD 0.124425.
- Base de coût unitaire : USD 0.004977.
- Unité de ressource :
similar_creator_point. - Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
- Les bases de coût ne déterminent pas le prix client final, y compris lorsqu'elles valent zéro.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: stringtarget
_account obligatoireCompte de départ : un identifiant de créateur (avec ou sans @) ou une URL de profil pour lequel trouver des créateurs similaires.
- Type: objectfilters
Filtres facultatifs appliqués avant la mise en correspondance. Tous les champs sont facultatifs.
- creatorType: array string[]
Types Types de compte de créateur, par exemple ["individual", "brand"].
- ethnicitiesType: array string[]
Ethnies de créateur déduites.
- faceType: array string[]
Visibilities Classifications de visibilité du visage, par exemple ["clear_face", "mixed", "no_face"].
- gendersType: array string[]
Genres de créateur déduits, par exemple ["female", "male"].
- languagesType: array string[]
Langues du créateur, par exemple ["en", "ja", "zh-cn"].
- maxType: number
Followers Nombre maximal de followers / d'abonnés.
- maxType: number
Play Count Nombre maximal de lectures / vues, mesuré par
playCountMetric. - minType: number
Followers Nombre minimal de followers / d'abonnés.
- minType: number
Play Count Nombre minimal de lectures / vues, mesuré par
playCountMetric. - playType: string enum
Count Metric Indique si
minPlayCount/maxPlayCountsont comparés à la médiane ou à la moyenne des lectures.valeurs- median
- average
- regionsType: array string[]
Régions du créateur (codes pays ISO), par exemple ["US", "GB", "JP"].
- workspaceType: boolean
Deduplication Enabled Lorsque la valeur est true, les créateurs déjà enregistrés dans votre espace de travail sont exclus des résultats.
- Type: integerlimitmin.:1max.:100
Integer numbers.
- Type: string enumplatformvaleurs
- instagram
- tiktok
- youtube
- Type: object200
Créateurs similaires renvoyés
- Type: stringbilling
Request Id Référence de facturation du fournisseur, et non un reçu de facturation Felo.
- Type: object · ResponseEb32A34A5274_CreatorSearchDatadata
- countType: number
Nombre de créateurs livrés. La facturation repose sur ce nombre livré.
- itemsType: array object[] · ResponseEb32A34A5274_Creator[]
Créateurs correspondants, triés par
scorepar ordre décroissant.Un créateur correspondant. Les champs sont cohérents entre Similar Creators et AI Search.
- accountType: array string[]
Positioning Tags courtes générées par IA résumant la niche/le positionnement du créateur.
- ageType: string
Range Tranche d'âge déduite (par exemple
25_34) ouunknown. - aiType: string
Description Résumé généré par IA du contenu, du style et des visuels typiques du créateur.
- averageType: number
Engagement Rate Taux d'engagement moyen (0–1).
- averageType: number
Play Count Nombre moyen de lectures/vues sur les publications récentes.
- biographyType: string
Texte de la bio du profil.
- emailType: string | null
E-mail de contact extrait du profil, lorsqu'il est disponible.
- ethnicityType: string
Origine ethnique déduite ou
unknown. - faceType: string
Visibility Classification de visibilité du visage, par exemple
clear_face,mixed,no_face. - followerType: number
Count Nombre d'abonnés.
- fullType: string
Name Nom d'affichage du créateur.
- genderType: string
Genre déduit, ou
unknown. - idType: string
ID du créateur sur la plateforme.
- languageType: string
Langue principale du contenu.
- medianType: number
Engagement Rate Taux d'engagement médian (0–1).
- medianType: number
Play Count Nombre médian de lectures / vues sur les publications récentes.
- platformType: string
Plateforme à laquelle appartient ce créateur : instagram, tiktok ou youtube.
- profileType: string
Url URL du profil du créateur.
- regionType: string
Région du créateur (code pays ISO).
- scoreType: number
Score de pertinence de la correspondance (0–1), trié par ordre décroissant.
- usernameType: string
Identifiant du créateur (sans le @ initial).
- Type: stringrequest
Id ID de requête pour l'assistance et la supervision.
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
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
}
}