データ API / Creator Discovery / Similar
Similar Creators
Finds creators similar to a seed profile, a natural-language content direction, or both, on YouTube or TikTok. platform is required; supply seedProfileUrl, contentDirection (max 800 characters) or both, with limit (1–100, default 25) and optional filters for regions, languages, follower and average-view ranges. The response echoes the resolved mode — homepage for a seed alone, direction for a direction alone, homepage_direction for both — and sets sourceUserId only when a seed resolved. Each match carries username, platformHandle, description, email, profileUrl, avatar, similarityScore (sorted descending), followerCount, averagePlayCount, lastPublishedTime, region and language. Field shape differs by platform: YouTube matches add channelId and channelTitle; TikTok matches add userId, uniqueId, nickname and averageLikeCount, none of which YouTube returns. Most matches already include an email; use lookupCreatorEmail for the ones that come back null and for Instagram creators, which this endpoint does not match.
パラメータ
パス・クエリ・ヘッダーのパラメータはありません。
リクエストボディ
platformstring必須指定できる値： youtube · tiktok
Target platform. Currently supports youtube and tiktok.
limitnumber任意Maximum number of creators to return. Default 25, range 1–100.
seedProfileUrlstring任意YouTube or TikTok creator profile URL as the seed for matching.
contentDirectionstring任意Natural-language description of the creator type you are looking for. Max 800 characters.
filtersobject任意regionsstring[]任意Creator regions, e.g. ["US", "GB", "JP"].
languagesstring[]任意Creator languages, e.g. ["en", "ja", "zh-cn"].
minFollowersnumber任意Minimum follower / subscriber count.
maxFollowersnumber任意Maximum follower / subscriber count.
minVideosAverageViewsnumber任意Minimum average view / play count.
maxVideosAverageViewsnumber任意Maximum average view / play count.
リクエスト例
curl -X POST "https://openapi.felo.ai/v1/beta/waveinflu/similar" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platform": "<string>",
"limit": 0,
"seedProfileUrl": "<string>",
"contentDirection": "<string>",
"filters": {}
}'レスポンス
レスポンスのフィールド
codenumber任意messagestring任意dataobject任意requestIdstring任意Request ID for support and monitoring.
platformstring任意Platform used for Wave AI matching.
modestring任意指定できる値： direction · homepage · homepage_direction
Search mode resolved by the system.
seedProfileUrlstring任意Seed profile URL if submitted in the request.
sourceUserIdstring任意Source channel / user ID resolved from seedProfileUrl.
contentDirectionstring任意Content direction if submitted in the request.
totalnumber任意Number of creators returned after Wave AI matching, filtering, and deduplication.
dataobject[]任意Matched creators, sorted by similarityScore descending.
usernamestring任意platformstring任意platformHandlestring任意channelIdstring任意YouTube only. Channel ID.
channelTitlestring任意YouTube only. Channel display name.
userIdstring任意TikTok only. Platform-side creator ID.
uniqueIdstring任意TikTok only. Creator handle without the leading @.
nicknamestring任意TikTok only. Creator display name.
descriptionstring任意email任意profileUrlstring任意avatarstring任意similarityScorenumber任意Wave AI match score (0.7–1.0). Used to rank results.
followerCountnumber任意averagePlayCountnumber任意averageLikeCountnumber任意TikTok only. YouTube results omit this field.
lastPublishedTimenumber任意regionstring任意languagestring任意quotaobject任意totalQuotanumber任意usedQuotanumber任意consumedQuotanumber任意Credits consumed to date; mirrors usedQuota.
statusstring任意Quota status, e.g. active.
expiresAt任意Quota expiry; null when the quota does not expire.
remainingQuotanumber任意reservedQuotanumber任意chargedQuotanumber任意refundQuotanumber任意refundStatusstring任意