Creator Data
Creator discovery and public contact information.
Creadores similares
Encuentra creadores similares usando el target_account obligatorio. platform es opcional, usa youtube de forma predeterminada y admite instagram, tiktok y youtube. Sigue los filtros documentados para acotar los resultados. billingRequestId es una referencia del proveedor, no un recibo de facturación de Felo.
Referencia de precios
- Medición: unidades de respuesta medidas.
- Estimación de referencia por solicitud: USD 0.124425.
- Base de costo unitario: USD 0.004977.
- Unidad de recurso:
similar_creator_point. - Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.
- Las bases de costo no determinan el precio final del cliente, incluso cuando son cero.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
- Tipo: stringtarget
_account obligatorioCuenta semilla: un identificador de creador (con o sin @) o URL de perfil para el que buscar creadores similares.
- Tipo: objectfilters
Filtros opcionales aplicados antes de la coincidencia. Todos los campos son opcionales.
- creatorTipo: array string[]
Types Tipos de cuenta de creador, por ejemplo ["individual", "brand"].
- ethnicitiesTipo: array string[]
Etnias de creador inferidas.
- faceTipo: array string[]
Visibilities Clasificaciones de visibilidad del rostro, por ejemplo ["clear_face", "mixed", "no_face"].
- gendersTipo: array string[]
Géneros de creador inferidos, por ejemplo ["female", "male"].
- languagesTipo: array string[]
Idiomas del creador, por ejemplo ["en", "ja", "zh-cn"].
- maxTipo: number
Followers Número máximo de seguidores / suscriptores.
- maxTipo: number
Play Count Número máximo de reproducciones / visualizaciones, medido por
playCountMetric. - minTipo: number
Followers Número mínimo de seguidores / suscriptores.
- minTipo: number
Play Count Número mínimo de reproducciones / visualizaciones, medido por
playCountMetric. - playTipo: string enum
Count Metric Si
minPlayCount/maxPlayCountse comparan con la mediana o con el promedio de reproducciones.valores- median
- average
- regionsTipo: array string[]
Regiones del creador (códigos de país ISO), por ejemplo ["US", "GB", "JP"].
- workspaceTipo: boolean
Deduplication Enabled Cuando es true, los creadores ya guardados en tu espacio de trabajo se excluyen de los resultados.
- Tipo: integerlimitmín.:1máx.:100
Integer numbers.
- Tipo: string enumplatformvalores
- instagram
- tiktok
- youtube
- Tipo: object200
Creadores similares devueltos
- Tipo: stringbilling
Request Id Referencia de facturación del proveedor, no un recibo de facturación de Felo.
- Tipo: object · ResponseEb32A34A5274_CreatorSearchDatadata
- countTipo: number
Número de creadores entregados. La facturación se basa en este recuento entregado.
- itemsTipo: array object[] · ResponseEb32A34A5274_Creator[]
Creadores coincidentes, ordenados por
scorede forma descendente.Un creador coincidente. Los campos son coherentes entre Similar Creators y AI Search.
- accountTipo: array string[]
Positioning Etiquetas cortas generadas por IA que resumen el nicho/posicionamiento del creador.
- ageTipo: string
Range Rango de edad inferido (por ejemplo,
25_34) ounknown. - aiTipo: string
Description Resumen generado por IA del contenido, el estilo y los elementos visuales habituales del creador.
- averageTipo: number
Engagement Rate Tasa media de interacción (0–1).
- averageTipo: number
Play Count Media de reproducciones/vistas en las publicaciones recientes.
- biographyTipo: string
Texto de la biografía del perfil.
- emailTipo: string | null
Correo electrónico de contacto extraído del perfil, cuando está disponible.
- ethnicityTipo: string
Etnia inferida o
unknown. - faceTipo: string
Visibility Clasificación de visibilidad del rostro, por ejemplo,
clear_face,mixed,no_face. - followerTipo: number
Count Número de seguidores/suscriptores.
- fullTipo: string
Name Nombre para mostrar del creador.
- genderTipo: string
Género inferido, o
unknown. - idTipo: string
ID del creador en la plataforma.
- languageTipo: string
Idioma principal del contenido.
- medianTipo: number
Engagement Rate Tasa de interacción mediana (0–1).
- medianTipo: number
Play Count Recuento mediano de reproducciones / visualizaciones en las publicaciones recientes.
- platformTipo: string
Plataforma a la que pertenece este creador: instagram, tiktok o youtube.
- profileTipo: string
Url URL del perfil del creador.
- regionTipo: string
Región del creador (código de país ISO).
- scoreTipo: number
Puntuación de relevancia de la coincidencia (0–1), ordenada de forma descendente.
- usernameTipo: string
Identificador del creador (sin la @ inicial).
- Tipo: stringrequest
Id ID de solicitud para soporte y supervisión.
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
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
}
}