Data 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Необязательный