AI Search

AI Search allows you to discover creators using natural language or image queries. Under the hood, it uses vector similarity search to find profiles and content that most closely match the concepts in your prompt. You can also combine these AI queries seamlessly with standard filters.

When to use it: This endpoint is ideal when your criteria go beyond basic metrics. Use it instead of regular Search when you require rich context about a creator's personal identity and niche, or when trying to match a specific visual style. Choose regular search endpoints when the workflow is mainly filter-based without needing semantic search over post content.

AI Search is limited to creators with more than 10,000 followers.

Available to Discovery API users.

Operations

Instagram Text-based AI Search

Request

Find influencers whose posts semantically (what appears in photos and videos) match the text query. Put language, locations, and similar criteria in filters. query does not support negations—use positive descriptions only. Default 1 RPS; higher limits available on request. 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(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
}

querystring, [ 1 .. 8192 ] characters

Natural-language text describing the creator and/or the type of content. Use this for querying content semantics (what appears in photos and videos).

Avoid using criteria for which a filter exists, e.g., language, locations, age ranges.

Negation is not supported - do not rely on "no", "not", "without", or "exclude" to remove topics.

Queries may be in any language, but different languages may yield different results; English usually yields the strongest matches.

Limit: 8192 characters or 512 words. If omitted, results are sorted by follower count.

Example:"Sporty stay at home mom sharing kids gut health tips and family wellness"

POST

/ai/instagram/text-search

curl -i -X POST \
  https://api.modash.io/v1/ai/instagram/text-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
    },
    "query": "Sporty stay at home mom sharing kids gut health tips and family wellness"
  }'

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

Response

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