YouTube Creator Lookalikes

Request

Find creators similar to one or more YouTube creators on any platform. Provide 1 to 5 source creator channel 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.

Security

accessToken

Bodyapplication/jsonrequired

One of:

pagenumber, >= 0

Page number (0-indexed). The offset is calculated as page * pageSize, so changing pageSize between pages will shift the window and may cause duplicate or missed results. The total number of results that can be accessed is limited to 1500 — that is, (page + 1) * pageSize must not exceed 1500. Requests beyond this limit will receive a 400 error.

Default:0

pageSizenumber, [ 1 .. 50 ]

Number of results per page. Each result costs 0.025 credits. The maximum total depth of results (page * pageSize + pageSize) is 1500. For example, with pageSize 50 you can paginate up to page 29.

Default:6

filtersobject(BaseAiSearchFilters)

Additional filters to refine the search results

Example:

{
  "followersCount": {
    "min": 13000
  },
  "gender": "FEMALE",
  "lastPostedInDays": 90,
  "accountType": "creator",
  "language": "en",
  "age": {
    "min": "18"
  },
  "engagementRate": {
    "min": 0.04
  },
  "postingFrequency": {
    "min": 4,
    "max": 20
  },
  "viewsCount": {
    "min": 10000,
    "calculationMethod": "median"
  },
  "followersGrowthRate": {
    "interval": "i3months",
    "min": 0.05
  },
  "hasEmail": true,
  "maxPostAgeMonths": 3
}

userIdsArray of strings, [ 1 .. 5 ] items

YouTube channel IDs or usernames of 1 to 5 source creators.

Example:

[
  "UCHnyfMqiRRG1u-2MsSQLbXA",
  "UCX6OQ3DkcsbYNE6H8uQQuVA"
]

targetPlatformstring

Target platform to find lookalikes on. Can be the same as the source platform (same-platform) or different (cross-platform).

Default:"youtube"

Enum:"instagram""tiktok""youtube"

userIdstringdeprecated

Deprecated. Use userIds instead.

Example:"UCHnyfMqiRRG1u-2MsSQLbXA"

POST

/ai/youtube/lookalikes

curl -i -X POST \
  https://api.modash.io/v1/ai/youtube/lookalikes \
  -H 'Authorization: Bearer <YOUR_token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 0,
    "pageSize": 6,
    "filters": {
      "followersCount": {
        "min": 13000
      },
      "gender": "FEMALE",
      "lastPostedInDays": 90,
      "accountType": "creator",
      "language": "en",
      "age": {
        "min": "18"
      },
      "engagementRate": {
        "min": 0.04
      },
      "postingFrequency": {
        "min": 4,
        "max": 20
      },
      "viewsCount": {
        "min": 10000,
        "calculationMethod": "median"
      },
      "followersGrowthRate": {
        "interval": "i3months",
        "min": 0.05
      },
      "hasEmail": true,
      "maxPostAgeMonths": 3
    },
    "userId": "UCHnyfMqiRRG1u-2MsSQLbXA",
    "userIds": [
      "UCHnyfMqiRRG1u-2MsSQLbXA",
      "UCX6OQ3DkcsbYNE6H8uQQuVA"
    ],
    "targetPlatform": "instagram"
  }'

Responses

Bodyapplication/json

errorboolean

If there is an error

Example:false

totalnumberrequired

Approximate number of lookalike profiles found. This is estimated from similarity score distribution and can exceed how many lookalikes pagination can actually return.

sourceProfilesArray of objects(LookalikeSourceProfile)required

Source creator profiles used to find lookalikes

lookalikesArray of objects(YTLookalikeProfile)required

List of lookalike influencer profiles

sourceProfileobject(LookalikeSourceProfile)requireddeprecated

Deprecated. Use sourceProfiles. Contains the first resolved source creator profile.

Response

{
  "error": false,
  "total": 0,
  "sourceProfile": {
    "userId": "173560420",
    "fullName": "Instagram",
    "username": "instagram",
    "profilePicture": "https://imgigp.modash.io/22159423_1794482210565499_9190891265074397184_n.jpg",
    "followersCount": 313560626,
    "engagementRate": 0.71,
    "postingFrequency": 12,
    "viewsCountMedian": 25000,
    "viewsCountMean": 32000,
    "url": "https://instagram.com/instagram",
    "accountCategory": "Sportsperson / Digital creator etc."
  },
  "sourceProfiles": [
    { … }
  ],
  "lookalikes": [
    { … }
  ]
}