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. 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
}

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).

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"

autoQueryOptimizationboolean or object

Example:

{
  "autoDetectFilters": true
}

One of:

Optimize query before searching. Pass a boolean to turn every optimization on or off, or an object to turn single optimizations on or off.

boolean

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",
    "autoQueryOptimization": {
      "autoDetectFilters": true
    }
  }'

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"
}