# Instagram Creator Lookalikes

Find creators similar to a given Instagram creator on any platform. Provide the source creator's user ID or username and a target platform. Results include similar creators with their profiles and posts. This API has a fixed 1 RPS limit. Each resulting profile costs 0.025 credits.

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

## Request fields (application/json):

  - `page` (number)
    Page number. The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results.

  - `pageSize` (number)
    Number of results per page. Each result costs 0.025 credits.

  - `filters` (object)
    Additional filters to refine the search results
    Example: {"followersCount":{"min":10000},"gender":"MALE","lastPostedInDays":90,"accountType":"creator","language":"es","age":{"min":"18"},"engagementRate":{"min":0.01},"hasEmail":true,"maxPostAgeMonths":3}

  - `filters.followersCount` (object)
    Filter by followers count
    Example: {"min":10000}

  - `filters.followersCount.min` (number)
    Minimum followers count. Number will be approximated to the nearest range lower or equal to the given number. Ranges are: 1000, 3000, 5000, 10000, 15000, 20000, 25000, 35000, 50000, 75000, 100000, 125000, 150000, 175000, 200000, 250000, 300000, 350000, 500000, 1000000, 2000000, 3000000.
    Example: 10000

  - `filters.followersCount.max` (number)
    Maximum followers count. Number will be approximated to the nearest range higher or equal to the given number. Ranges are: 1000, 3000, 5000, 10000, 15000, 20000, 25000, 35000, 50000, 75000, 100000, 125000, 150000, 175000, 200000, 250000, 300000, 350000, 500000, 1000000, 2000000, 3000000.

  - `filters.locations` (array)
    Filter by locations (use Locations dictionary endpoint to get the location IDs)

  - `filters.gender` (string)
    Filter by gender; KNOWN -> male or female, UNKNOWN -> gender neutral
    Enum: "MALE", "FEMALE", "KNOWN", "UNKNOWN"

  - `filters.lastPostedInDays` (number)
    Filter by influencers with latest post date, in days. P.S. we update profiles every 4 weeks and this lag should be considered when using this field.
    Example: 90

  - `filters.accountType` (string)
    Filter by account type
    Enum: "creator", "brand"

  - `filters.language` (string)
    Filter by language (use Languages dictionary endpoint to get the language IDs)
    Example: "es"

  - `filters.age` (object)
    Filter by age range
    Example: {"min":"18"}

  - `filters.age.min` (string)
    Minimum age range
    Enum: "13", "18", "25", "35", "45", "65"

  - `filters.age.max` (string)
    Maximum age range
    Enum: "18", "25", "35", "45", "65"

  - `filters.engagementRate` (object)
    Filter by engagement rate
    Example: {"min":0.01}

  - `filters.engagementRate.min` (number)
    Minimum engagement rate (in percentage, 0.01 = 1%)
    Example: 0.01

  - `filters.hasEmail` (boolean)
    Filter by whether the influencer has an email
    Example: true

  - `filters.brands` (array)
    Filter by brands (Use AI search's Brand Dictionary endpoint to get the brand names. P.S. this is a different endpoint than existing Brand Dictionary endpoint).

  - `filters.username` (string)
    Username to search for

  - `filters.maxPostAgeMonths` (number)
    Filter by the maximum age of the posts in months. Used to request more recent posts.
    Enum: 3, 6, 9, 12

  - `filters.contentType` (string)
    Filter by content type. Allowed values: video, image. If not provided, both video and image content will be returned.
    Enum: "video", "image"

  - `filters.audience` (object)
    Filter by Audience

  - `filters.audience.credibility` (number)
    Filter by Audience Credibility. The value is the inverse of fake followers, meaning 25% fake followers would translate to 0.75 of audience credibility.

  - `userId` (string, required)
    Instagram user ID or username of the source creator.
    Example: "173560420"

  - `targetPlatform` (string)
    Target platform to find lookalikes on. Can be the same as the source platform (same-platform) or different (cross-platform).
    Enum: "instagram", "tiktok", "youtube"

## Response 200 fields (application/json):

  - `error` (boolean)
    If there is an error

  - `total` (number, required)
    Total number of lookalike profiles found

  - `sourceProfile` (object, required)
    The source creator profile used to find lookalikes

  - `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
    Example: 0.01

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

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

  - `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
    Example: 0.01

  - `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.playsCount` (number, required)
    Plays count

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