# TikTok Creator Lookalikes

Find creators similar to one or more TikTok creators on any platform. Provide 1 to 5 source creator user IDs or usernames in userIds and a target platform. When multiple sources are provided, results are semantically similar to their combined creator profiles. The userId field is deprecated; use userIds, including for single-creator searches. Results include similar creators with their profiles and posts. Default 1 RPS. Each resulting profile costs 0.025 credits.

Endpoint: POST /ai/tiktok/lookalikes
Security: accessToken

## Response 200 fields (application/json):

  - `error` (boolean)
    If there is an error
    Example: false

  - `total` (number, required)
    Approximate number of lookalike profiles found. This is estimated from similarity score distribution and can exceed how many lookalikes pagination can actually return.

  - `sourceProfile` (object, required)
    Deprecated. Use sourceProfiles. Contains the first resolved source creator profile.

  - `sourceProfile.userId` (string)
    User ID
    Example: 173560420

  - `sourceProfile.fullName` (string)
    Full name
    Example: Instagram

  - `sourceProfile.username` (string, required)
    Username
    Example: instagram

  - `sourceProfile.profilePicture` (string, required)
    Profile Picture
    Example: https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg

  - `sourceProfile.followersCount` (number, required)
    Followers count
    Example: 313560626

  - `sourceProfile.engagementRate` (number, required)
    Engagement rate as a percentage (0.71 = 0.71%)
    Example: 0.71

  - `sourceProfile.postingFrequency` (number, required)
    Average posts per 30-day month
    Example: 12

  - `sourceProfile.viewsCountMedian` (number)
    Median per-post view count over the last 60 days
    Example: 25000

  - `sourceProfile.viewsCountMean` (number)
    Mean per-post view count over the last 60 days
    Example: 32000

  - `sourceProfile.url` (string, required)
    Profile URL
    Example: https://instagram.com/instagram

  - `sourceProfile.accountCategory` (string)
    Account category
    Example: Sportsperson / Digital creator etc.

  - `sourceProfiles` (array, required)
    Source creator profiles used to find lookalikes

  - `lookalikes` (array, required)
    List of lookalike influencer profiles

  - `lookalikes.userId` (string)
    User ID
    Example: 173560420

  - `lookalikes.fullName` (string)
    Full name
    Example: Instagram

  - `lookalikes.username` (string, required)
    Username
    Example: instagram

  - `lookalikes.profilePicture` (string, required)
    Profile Picture
    Example: https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg

  - `lookalikes.followersCount` (number, required)
    Followers count
    Example: 313560626

  - `lookalikes.engagementRate` (number, required)
    Engagement rate as a percentage (0.71 = 0.71%)
    Example: 0.71

  - `lookalikes.postingFrequency` (number, required)
    Average posts per 30-day month
    Example: 12

  - `lookalikes.viewsCountMedian` (number)
    Median per-post view count over the last 60 days
    Example: 25000

  - `lookalikes.viewsCountMean` (number)
    Mean per-post view count over the last 60 days
    Example: 32000

  - `lookalikes.followersGrowthRate` (number)
    Followers growth rate over the interval requested through the followersGrowthRate filter, as a decimal fraction (0.05 = 5% growth). Defaults to the trailing six months when the filter is not used, and is omitted when no growth rate is available for that interval.
    Example: 0.05

  - `lookalikes.recentPosts` (array, required)
    Recent posts (not necessarily relevant to the search query). P.S. we update profiles every 4 weeks and this lag should be considered when using this field.

  - `lookalikes.recentPosts.id` (string, required)
    Post ID

  - `lookalikes.recentPosts.url` (string, required)
    Post URL

  - `lookalikes.recentPosts.thumbnail` (string, required)
    Post thumbnail URL

  - `lookalikes.recentPosts.stats` (object, required)
    Post statistics

  - `lookalikes.recentPosts.stats.likesCount` (number, required)
    Likes count; -1 if likes count is hidden

  - `lookalikes.recentPosts.stats.commentsCount` (number, required)
    Comments count; -1 if comments count is hidden

  - `lookalikes.recentPosts.stats.sharesCount` (number, required)
    Shares count

  - `lookalikes.recentPosts.stats.playsCount` (number, required)
    Plays count

  - `lookalikes.recentPosts.stats.collectsCount` (number, required)
    Collects count

  - `lookalikes.accountCategory` (string)
    Account category
    Example: Sportsperson / Digital creator etc.