Creator Data
Creator discovery and public contact information.
Criadores semelhantes
Encontra criadores semelhantes usando o target_account obrigatório. platform é opcional, usa youtube por padrão e aceita instagram, tiktok e youtube. Siga os filtros documentados para restringir os resultados. billingRequestId é uma referência do provedor, não um recibo de cobrança da Felo.
Referência de preços
- Medição: unidades de resposta medidas.
- Estimativa de referência por requisição: USD 0.124425.
- Base de custo unitário: USD 0.004977.
- Unidade de recurso:
similar_creator_point. - Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.
- As bases de custo não definem o preço final do cliente, inclusive quando forem zero.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
- Tipo: stringtarget
_account obrigatórioConta inicial: um handle de criador (com ou sem @) ou URL de perfil para o qual encontrar criadores semelhantes.
- Tipo: objectfilters
Filtros opcionais aplicados antes da correspondência. Todos os campos são opcionais.
- creatorTipo: array string[]
Types Tipos de conta de criador, por exemplo ["individual", "brand"].
- ethnicitiesTipo: array string[]
Etnias de criador inferidas.
- faceTipo: array string[]
Visibilities Classificações de visibilidade do rosto, por exemplo ["clear_face", "mixed", "no_face"].
- gendersTipo: array string[]
Gêneros de criador inferidos, por exemplo ["female", "male"].
- languagesTipo: array string[]
Idiomas do criador, por exemplo ["en", "ja", "zh-cn"].
- maxTipo: number
Followers Número máximo de seguidores / inscritos.
- maxTipo: number
Play Count Número máximo de reproduções / visualizações, medido por
playCountMetric. - minTipo: number
Followers Número mínimo de seguidores / inscritos.
- minTipo: number
Play Count Número mínimo de reproduções / visualizações, medido por
playCountMetric. - playTipo: string enum
Count Metric Se
minPlayCount/maxPlayCountsão comparados à mediana ou à média de reproduções.valores- median
- average
- regionsTipo: array string[]
Regiões do criador (códigos de país ISO), por exemplo ["US", "GB", "JP"].
- workspaceTipo: boolean
Deduplication Enabled Quando true, criadores já salvos no seu workspace são excluídos dos resultados.
- Tipo: integerlimitmín:1máx:100
Integer numbers.
- Tipo: string enumplatformvalores
- instagram
- tiktok
- youtube
- Tipo: object200
Criadores semelhantes retornados
- Tipo: stringbilling
Request Id Referência de cobrança do provedor, não um recibo de cobrança da Felo.
- Tipo: object · ResponseEb32A34A5274_CreatorSearchDatadata
- countTipo: number
Número de criadores entregues. A cobrança se baseia nessa contagem entregue.
- itemsTipo: array object[] · ResponseEb32A34A5274_Creator[]
Criadores correspondentes, ordenados por
scoreem ordem decrescente.Um criador correspondente. Os campos são consistentes entre Similar Creators e AI Search.
- accountTipo: array string[]
Positioning Tags curtas geradas por IA que resumem o nicho/posicionamento do criador.
- ageTipo: string
Range Faixa etária inferida (por exemplo,
25_34) ouunknown. - aiTipo: string
Description Resumo gerado por IA do conteúdo, estilo e visuais típicos do criador.
- averageTipo: number
Engagement Rate Taxa média de engajamento (0–1).
- averageTipo: number
Play Count Média de reproduções/exibições nas publicações recentes.
- biographyTipo: string
Texto da bio do perfil.
- emailTipo: string | null
E-mail de contato extraído do perfil, quando disponível.
- ethnicityTipo: string
Etnia inferida ou
unknown. - faceTipo: string
Visibility Classificação de visibilidade do rosto, por exemplo,
clear_face,mixed,no_face. - followerTipo: number
Count Contagem de seguidores/assinantes.
- fullTipo: string
Name Nome de exibição do criador.
- genderTipo: string
Gênero inferido, ou
unknown. - idTipo: string
ID do criador na plataforma.
- languageTipo: string
Idioma principal do conteúdo.
- medianTipo: number
Engagement Rate Taxa de engajamento mediana (0–1).
- medianTipo: number
Play Count Contagem mediana de reproduções / visualizações nos posts recentes.
- platformTipo: string
Plataforma à qual este criador pertence: instagram, tiktok ou youtube.
- profileTipo: string
Url URL do perfil do criador.
- regionTipo: string
Região do criador (código de país ISO).
- scoreTipo: number
Pontuação de relevância da correspondência (0–1), ordenada de forma decrescente.
- usernameTipo: string
Handle do criador (sem o @ inicial).
- Tipo: stringrequest
Id ID da requisição para suporte e monitoramento.
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
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
}
}