Skip to content
Discovery API/
/
Instagram Image-based AI...

Instagram Image-based AI Search
deprecated

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. Default 1 RPS. Each resulting profile costs 0.025 credits. Unknown request body fields are rejected with a 400 error identifying the invalid field.

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(IGAiSearchFilters)

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
  },
  "postingFrequency": {
    "min": 2
  },
  "followersGrowthRate": {
    "interval": "i6months",
    "min": 0.01
  },
  "hasEmail": true,
  "maxPostAgeMonths": 3
}
imageTypestringrequired

Image type

Enum:"image/jpeg""image/png""image/webp"
base64Imagestring, (base64), <= 6990507 charactersrequired

Image (base64 encoded), max size 5MB

curl -i -X POST \
  https://api.modash.io/v1/ai/image-search \
  -H 'Authorization: Bearer <YOUR_token_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 0,
    "pageSize": 6,
    "filters": {
      "followersCount": {
        "min": 10000
      },
      "gender": "MALE",
      "lastPostedInDays": 90,
      "accountType": "creator",
      "language": "es",
      "age": {
        "min": "18"
      },
      "engagementRate": {
        "min": 0.01
      },
      "postingFrequency": {
        "min": 2
      },
      "followersGrowthRate": {
        "interval": "i6months",
        "min": 0.01
      },
      "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(AiSearchProfile)required

List of influencer profiles matching the search query and filters

detectedFiltersobject(BaseAiSearchFilters)

Filters detected from the query and applied to this search. Omitted when filter detection is off, fails, or finds nothing.

effectiveQuerystring

Query text used for semantic matching after detected filter terms were removed. Omitted when filter detection is off, fails, or finds nothing.

Response
{
  "error": false,
  "total": 0,
  "profiles": [
    { … }
  ],
  "detectedFilters": {
    "followersCount": { … },
    "locations": [ … ],
    "gender": "MALE",
    "lastPostedInDays": 90,
    "accountType": "creator",
    "language": "string",
    "age": { … },
    "engagementRate": { … },
    "postingFrequency": { … },
    "viewsCount": { … },
    "followersGrowthRate": { … },
    "hasEmail": true,
    "brands": [ … ],
    "username": "string",
    "maxPostAgeMonths": 3,
    "contentType": "video",
    "textTags": [ … ],
    "bio": [ … ],
    "keywords": [ … ],
    "audio": [ … ],
    "lists": { … }
  },
  "effectiveQuery": "string"
}