Skip to content
Discovery API/
/
Instagram Text-based AI S...

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": [
    { … }
  ]
}