Skip to main content
POST
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 modehomepage 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. Measured at 4.2 KB for 5 YouTube matches (about 8 seconds) and 2.5 KB for 3 TikTok matches. Most matches already include an email. Use post_waveinflu_email_lookup for the ones that come back null, and for Instagram creators, which this endpoint does not match.

Example

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
platform
enum<string>
required

Target platform. Currently supports youtube and tiktok.

Available options:
youtube,
tiktok
Example:

"youtube"

limit
number
default:25

Maximum number of creators to return. Default 25, range 1–100.

Required range: 1 <= x <= 100
Example:

10

seedProfileUrl
string

YouTube or TikTok creator profile URL as the seed for matching.

Example:

"https://www.youtube.com/@mkbhd"

contentDirection
string

Natural-language description of the creator type you are looking for. Max 800 characters.

Maximum string length: 800
Example:

"consumer tech creators covering AI apps, Android phones, productivity gadgets, and honest product reviews"

filters
object

Response

200 - application/json

Similar creators completed

code
number
Example:

1000

message
string
Example:

"Similar creators completed"

data
object