Creator Data
Creator discovery and public contact information.
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.
- Тип: string enumplatformобязательно
Target platform. Currently supports youtube and tiktok.
значения- youtube
- tiktok
- Тип: stringcontent
Direction макс. длина:800Natural-language description of the creator type you are looking for. Max 800 characters.
- Тип: object · SimilarCreatorFiltersfilters
- languagesТип: array string[]
Creator languages, e.g. ["en", "ja", "zh-cn"].
- maxТип: number
Followers Maximum follower / subscriber count.
- maxТип: number
Videos Average Views Maximum average view / play count.
- minТип: number
Followers Minimum follower / subscriber count.
- minТип: number
Videos Average Views Minimum average view / play count.
- regionsТип: array string[]
Creator regions, e.g. ["US", "GB", "JP"].
- Тип: numberlimitмин.:1макс.:100
Maximum number of creators to return. Default 25, range 1–100.
- Тип: stringseed
Profile Url YouTube or TikTok creator profile URL as the seed for matching.
- Тип: object200
Similar creators completed
- Тип: numbercode
- Тип: object · SimilarDatadata
- contentТип: string
Direction Content direction if submitted in the request.
- dataТип: array object[] · SimilarCreator[]
Matched creators, sorted by similarityScore descending.
- avatarТип: string
- averageТип: number
Like Count TikTok only. YouTube results omit this field.
- averageТип: number
Play Count - channelТип: string
Id YouTube only. Channel ID.
- channelТип: string
Title YouTube only. Channel display name.
- descriptionТип: string
- emailТип: string может быть null
- followerТип: number
Count - languageТип: string
- lastТип: number
Published Time - nicknameТип: string
TikTok only. Creator display name.
- platformТип: string
- platformТип: string
Handle - profileТип: string
Url - regionТип: string
- similarityТип: number
Score Wave AI match score (0.7–1.0). Used to rank results.
- uniqueТип: string
Id TikTok only. Creator handle without the leading @.
- userТип: string
Id TikTok only. Platform-side creator ID.
- usernameТип: string
- modeТип: string enum
Search mode resolved by the system.
значения- direction
- homepage
- homepage
_direction
- platformТип: string
Platform used for Wave AI matching.
- quotaТип: object · SimilarQuota
- chargedТип: number
Quota - consumedТип: number
Quota Credits consumed to date; mirrors usedQuota.
- expiresТип: string может быть null
At Quota expiry; null when the quota does not expire.
- refundТип: number
Quota - refundТип: string
Status - remainingТип: number
Quota - reservedТип: number
Quota - statusТип: string
Quota status, e.g. active.
- totalТип: number
Quota - usedТип: number
Quota
- requestТип: string
Id Request ID for support and monitoring.
- seedТип: string
Profile Url Seed profile URL if submitted in the request.
- sourceТип: string
User Id Source channel / user ID resolved from seedProfileUrl.
- totalТип: number
Number of creators returned after Wave AI matching, filtering, and deduplication.
- Тип: stringmessage
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
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",
"limit": 10,
"seedProfileUrl": "https://www.youtube.com/@mkbhd",
"contentDirection": "consumer tech creators covering AI apps, Android phones, productivity gadgets, and honest product reviews",
"filters": {
"regions": [
""
],
"languages": [
""
],
"minFollowers": 1,
"maxFollowers": 1,
"minVideosAverageViews": 1,
"maxVideosAverageViews": 1
}
}'
{
"code": 1000,
"message": "Similar creators completed",
"data": {
"requestId": "string",
"platform": "string",
"mode": "direction",
"seedProfileUrl": "string",
"sourceUserId": "string",
"contentDirection": "string",
"total": 1,
"data": [
{
"username": "string",
"platform": "string",
"platformHandle": "string",
"channelId": "string",
"channelTitle": "string",
"userId": "string",
"uniqueId": "string",
"nickname": "string",
"description": "string",
"email": "string",
"profileUrl": "string",
"avatar": "string",
"similarityScore": 1,
"followerCount": 1,
"averagePlayCount": 1,
"averageLikeCount": 1,
"lastPublishedTime": 1,
"region": "string",
"language": "string"
}
],
"quota": {
"totalQuota": 1,
"usedQuota": 1,
"consumedQuota": 1,
"status": "string",
"expiresAt": "string",
"remainingQuota": 1,
"reservedQuota": 1,
"chargedQuota": 1,
"refundQuota": 1,
"refundStatus": "string"
}
}
}