Skip to main content
All parameters are passed as query string parameters on GET /v1/search.

​
Parameter table

​
string
Free-text keyword search. Matches against the influencer’s name and bio.Examples: "yoga teacher NYC", "vegan chef", "travel photographer"At least one of query or category is required.
​
string
Business category to filter by. Only returns accounts with a matching Instagram business category.Valid values:At least one of query or category is required.
​
string
Two-letter country code. Filters by the influencer’s detected location.Valid values (common):Most ISO 3166-1 alpha-2 codes are supported.
​
string
Gender filter. Uses face detection on profile photos.Valid values: "male", "female"
​
integer
Minimum follower count (inclusive).Range: 0 to 1,000,000,000Default: none (no minimum)
​
integer
Maximum follower count (inclusive). Useful for finding micro-influencers.Range: 0 to 1,000,000,000Default: none (no maximum)
​
integer
Maximum number of results to return.Range: 1 to 100Default: 20Affects pricing — see Pricing.

​
Combining filters

All filters can be combined. The API returns results matching all specified filters (AND logic).
This returns up to 50 female fitness influencers in the US with 10K-100K followers.

​
Requirements

  • At least one of query or category must be provided
  • If both are provided, category filters the results and query performs a keyword search within that category

​
Notes

  • Country codes are case-insensitive (us and US both work)
  • Gender detection uses facial analysis on profile photos — accuracy may vary
  • Results are sorted by follower count (descending)
  • The max_followers filter enables micro-influencer discovery