YouTube Image-based AI Search

Request

Search for influencers using an image based query (along with other filters) and you will get influencers who have posted content similar to the query image. The image is matched against video and short thumbnails. Default 1 RPS. Each resulting profile costs 0.025 credits.

Security

accessToken

Bodyapplication/jsonrequired

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
}

imageTypestringrequired

Image type

Enum:"image/jpeg""image/png""image/webp"

base64Imagestring, (base64), <= 6990507 charactersrequired

Image (base64 encoded), max size 5MB

POST

/ai/youtube/image-search

curl -i -X POST \
  https://api.modash.io/v1/ai/youtube/image-search \
  -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
    },
    "imageType": "image/jpeg",
    "base64Image": "string"
  }'

Responses

Bodyapplication/json

errorboolean

If there is an error

Example:false

totalnumberrequired

Approximate number of profiles matching the search query. This is estimated from similarity score distribution and can exceed how many profiles pagination can actually return.

profilesArray of objects(YTAiSearchProfile)required

List of influencer profiles matching the search query and filters

Response

{
  "error": false,
  "total": 0,
  "profiles": [
    { … }
  ]
}