# 유사 크리에이터 **API:** Data API **Endpoint:** `POST /v1/beta/waveinflu/similar` **Tags:** Creator Data 필수 target_account로 유사한 크리에이터를 찾습니다. platform은 선택 사항이며 기본값은 youtube이고 instagram, tiktok, youtube를 지원합니다. 문서화된 필터로 결과를 좁히세요. billingRequestId는 공급자 참조이며 Felo 청구 영수증이 아닙니다. ### 가격 참고 - 과금 기준: 측정된 응답 단위. - 참고 요청 추정치: USD 0.124425. - 단위 원가 기준: USD 0.004977. - 리소스 단위: `similar_creator_point`. - 참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요. - 원가 기준은 0인 경우를 포함해 최종 고객 가격을 확정하지 않습니다. 참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Request body Required: **yes** ### application/json Schema: ```json { "type": "object", "properties": { "platform": { "default": "youtube", "enum": [ "instagram", "tiktok", "youtube" ], "type": "string" }, "target_account": { "type": "string", "description": "시드 계정: 유사한 크리에이터를 찾을 기준이 되는 크리에이터 핸들(@ 포함 또는 미포함) 또는 프로필 URL입니다.", "example": "@onkimia" }, "limit": { "default": 25, "maximum": 100, "minimum": 1, "type": "integer" }, "filters": { "type": "object", "description": "매칭 전에 적용되는 선택적 필터입니다. 모든 필드는 선택 사항입니다.", "properties": { "regions": { "type": "array", "items": { "type": "string" }, "description": "크리에이터 지역(ISO 국가 코드)입니다(예: [\"US\", \"GB\", \"JP\"])." }, "languages": { "type": "array", "items": { "type": "string" }, "description": "크리에이터 언어입니다(예: [\"en\", \"ja\", \"zh-cn\"])." }, "minFollowers": { "type": "number", "description": "최소 팔로워/구독자 수입니다." }, "maxFollowers": { "type": "number", "description": "최대 팔로워/구독자 수입니다." }, "minPlayCount": { "type": "number", "description": "최소 재생/조회 수이며 `playCountMetric`으로 측정합니다." }, "maxPlayCount": { "type": "number", "description": "최대 재생/조회 수이며 `playCountMetric`으로 측정합니다." }, "playCountMetric": { "type": "string", "enum": [ "median", "average" ], "description": "`minPlayCount`/`maxPlayCount`를 중앙값과 비교할지 평균 재생 수와 비교할지 여부입니다." }, "genders": { "type": "array", "items": { "type": "string" }, "description": "추론된 크리에이터 성별입니다(예: [\"female\", \"male\"])." }, "ethnicities": { "type": "array", "items": { "type": "string" }, "description": "추론된 크리에이터 인종입니다." }, "creatorTypes": { "type": "array", "items": { "type": "string" }, "description": "크리에이터 계정 유형입니다(예: [\"individual\", \"brand\"])." }, "faceVisibilities": { "type": "array", "items": { "type": "string" }, "description": "얼굴 가시성 분류입니다(예: [\"clear_face\", \"mixed\", \"no_face\"])." }, "workspaceDeduplicationEnabled": { "type": "boolean", "description": "true이면 워크스페이스에 이미 저장된 크리에이터는 결과에서 제외됩니다." } } } }, "required": [ "target_account" ] } ``` ## Responses ### 200 — 유사 크리에이터가 반환되었습니다. Headers: - `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다. **application/json** Schema: object ```json { "type": "object", "properties": { "requestId": { "type": "string", "description": "지원 및 모니터링을 위한 요청 ID입니다.", "example": "req-b33" }, "billingRequestId": { "type": "string", "description": "공급자 청구 참조이며 Felo 청구 영수증이 아닙니다.", "example": "a328145e-3cc9-45c7-89f9-a5f15b236d4f" }, "data": { "$ref": "#/components/schemas/ResponseEb32A34A5274_CreatorSearchData" } } } ``` ### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요. ### 401 — 유효한 Felo API 키가 필요합니다. ### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다. ### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다. ### 429 — 요청 또는 지출 한도에 도달했습니다. ### 502 — 서비스가 요청을 완료할 수 없습니다. ### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다. ### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다. ### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다. **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseEb32A34A5274_Creator `#/components/schemas/ResponseEb32A34A5274_Creator` ```json { "type": "object", "description": "매칭된 크리에이터입니다. 필드는 Similar Creators와 AI Search에서 동일합니다.", "properties": { "id": { "type": "string", "description": "플랫폼 측 크리에이터 ID입니다." }, "username": { "type": "string", "description": "크리에이터 핸들(앞의 @ 제외)입니다." }, "fullName": { "type": "string", "description": "크리에이터 표시 이름입니다." }, "biography": { "type": "string", "description": "프로필 소개 텍스트입니다." }, "email": { "type": [ "string", "null" ], "description": "사용 가능한 경우 프로필에서 추출한 연락처 이메일입니다." }, "followerCount": { "type": "number", "description": "팔로워/구독자 수입니다." }, "region": { "type": "string", "description": "크리에이터 지역(ISO 국가 코드)입니다." }, "language": { "type": "string", "description": "기본 콘텐츠 언어입니다." }, "averagePlayCount": { "type": "number", "description": "최근 게시물의 평균 재생/조회수입니다." }, "medianPlayCount": { "type": "number", "description": "최근 게시물의 중앙값 재생/조회 수입니다." }, "averageEngagementRate": { "type": "number", "description": "평균 참여율(0–1)입니다." }, "medianEngagementRate": { "type": "number", "description": "중앙값 참여율(0–1)입니다." }, "gender": { "type": "string", "description": "추론된 성별 또는 `unknown`입니다." }, "ageRange": { "type": "string", "description": "추정 연령대(예: `25_34`) 또는 `unknown`입니다." }, "ethnicity": { "type": "string", "description": "추정 인종 또는 `unknown`입니다." }, "faceVisibility": { "type": "string", "description": "얼굴 노출 분류입니다(예: `clear_face`, `mixed`, `no_face`)." }, "accountPositioning": { "type": "array", "items": { "type": "string" }, "description": "크리에이터의 니치/포지셔닝을 요약한 짧은 AI 생성 태그입니다." }, "aiDescription": { "type": "string", "description": "크리에이터의 콘텐츠, 스타일, 일반적인 비주얼을 AI가 생성한 요약입니다." }, "platform": { "type": "string", "description": "이 크리에이터가 속한 플랫폼입니다: instagram, tiktok, youtube." }, "profileUrl": { "type": "string", "description": "크리에이터 프로필 URL입니다." }, "score": { "type": "number", "description": "매칭 관련성 점수(0–1)이며, 내림차순으로 정렬됩니다." } } } ``` ### ResponseEb32A34A5274_CreatorSearchData `#/components/schemas/ResponseEb32A34A5274_CreatorSearchData` ```json { "type": "object", "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseEb32A34A5274_Creator" }, "description": "`score` 내림차순으로 정렬된 매칭 크리에이터입니다." }, "count": { "type": "number", "description": "반환된 크리에이터 수입니다. 청구는 반환된 수를 기준으로 합니다.", "example": 2 } } } ```