Creator Data
Creator discovery and public contact information.
유사 크리에이터
필수 target_account로 유사한 크리에이터를 찾습니다. platform은 선택 사항이며 기본값은 youtube이고 instagram, tiktok, youtube를 지원합니다. 문서화된 필터로 결과를 좁히세요. billingRequestId는 공급자 참조이며 Felo 청구 영수증이 아닙니다.
가격 참고
- 과금 기준: 측정된 응답 단위.
- 참고 요청 추정치: USD 0.124425.
- 단위 원가 기준: USD 0.004977.
- 리소스 단위:
similar_creator_point. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.
- 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다.
참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
- 유형: stringtarget
_account 필수시드 계정: 유사한 크리에이터를 찾을 기준이 되는 크리에이터 핸들(@ 포함 또는 미포함) 또는 프로필 URL입니다.
- 유형: objectfilters
매칭 전에 적용되는 선택적 필터입니다. 모든 필드는 선택 사항입니다.
- creator유형: array string[]
Types 크리에이터 계정 유형입니다(예: ["individual", "brand"]).
- ethnicities유형: array string[]
추론된 크리에이터 인종입니다.
- face유형: array string[]
Visibilities 얼굴 가시성 분류입니다(예: ["clear_face", "mixed", "no_face"]).
- genders유형: array string[]
추론된 크리에이터 성별입니다(예: ["female", "male"]).
- languages유형: array string[]
크리에이터 언어입니다(예: ["en", "ja", "zh-cn"]).
- max유형: number
Followers 최대 팔로워/구독자 수입니다.
- max유형: number
Play Count 최대 재생/조회 수이며
playCountMetric으로 측정합니다. - min유형: number
Followers 최소 팔로워/구독자 수입니다.
- min유형: number
Play Count 최소 재생/조회 수이며
playCountMetric으로 측정합니다. - play유형: string 열거형
Count Metric minPlayCount/maxPlayCount를 중앙값과 비교할지 평균 재생 수와 비교할지 여부입니다.값- median
- average
- regions유형: array string[]
크리에이터 지역(ISO 국가 코드)입니다(예: ["US", "GB", "JP"]).
- workspace유형: boolean
Deduplication Enabled true이면 워크스페이스에 이미 저장된 크리에이터는 결과에서 제외됩니다.
- 유형: integerlimit최솟값:1최댓값:100
Integer numbers.
- 유형: string 열거형platform값
- instagram
- tiktok
- youtube
- 유형: object200
유사 크리에이터가 반환되었습니다.
- 유형: stringbilling
Request Id 공급자 청구 참조이며 Felo 청구 영수증이 아닙니다.
- 유형: object · ResponseEb32A34A5274_CreatorSearchDatadata
- count유형: number
반환된 크리에이터 수입니다. 청구는 반환된 수를 기준으로 합니다.
- items유형: array object[] · ResponseEb32A34A5274_Creator[]
score내림차순으로 정렬된 매칭 크리에이터입니다.매칭된 크리에이터입니다. 필드는 Similar Creators와 AI Search에서 동일합니다.
- account유형: array string[]
Positioning 크리에이터의 니치/포지셔닝을 요약한 짧은 AI 생성 태그입니다.
- age유형: string
Range 추정 연령대(예:
25_34) 또는unknown입니다. - ai유형: string
Description 크리에이터의 콘텐츠, 스타일, 일반적인 비주얼을 AI가 생성한 요약입니다.
- average유형: number
Engagement Rate 평균 참여율(0–1)입니다.
- average유형: number
Play Count 최근 게시물의 평균 재생/조회수입니다.
- biography유형: string
프로필 소개 텍스트입니다.
- email유형: string | null
사용 가능한 경우 프로필에서 추출한 연락처 이메일입니다.
- ethnicity유형: string
추정 인종 또는
unknown입니다. - face유형: string
Visibility 얼굴 노출 분류입니다(예:
clear_face,mixed,no_face). - follower유형: number
Count 팔로워/구독자 수입니다.
- full유형: string
Name 크리에이터 표시 이름입니다.
- gender유형: string
추론된 성별 또는
unknown입니다. - id유형: string
플랫폼 측 크리에이터 ID입니다.
- language유형: string
기본 콘텐츠 언어입니다.
- median유형: number
Engagement Rate 중앙값 참여율(0–1)입니다.
- median유형: number
Play Count 최근 게시물의 중앙값 재생/조회 수입니다.
- platform유형: string
이 크리에이터가 속한 플랫폼입니다: instagram, tiktok, youtube.
- profile유형: string
Url 크리에이터 프로필 URL입니다.
- region유형: string
크리에이터 지역(ISO 국가 코드)입니다.
- score유형: number
매칭 관련성 점수(0–1)이며, 내림차순으로 정렬됩니다.
- username유형: string
크리에이터 핸들(앞의 @ 제외)입니다.
- 유형: stringrequest
Id 지원 및 모니터링을 위한 요청 ID입니다.
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
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
}
}