数据 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可选