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

​
Parameter table

​
query
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.
​
category
string
Business category to filter by. Only returns accounts with a matching Instagram business category.Valid values:
CategoryCategoryCategory
BeautyFitnessTech
FoodTravelFashion
HealthMusicGaming
ArtPhotographyEducation
BusinessEntertainmentSports
LifestyleAutomotiveFinance
At least one of query or category is required.
​
country
string
Two-letter country code. Filters by the influencer’s detected location.Valid values (common):
CodeCountryCodeCountry
USUnited StatesUKUnited Kingdom
DEGermanyFRFrance
ITItalyESSpain
CACanadaAUAustralia
BRBrazilINIndia
NLNetherlandsSESweden
MXMexicoJPJapan
KRSouth KoreaTRTurkey
RURussiaPLPoland
AEUAESASaudi Arabia
Most ISO 3166-1 alpha-2 codes are supported.
​
gender
string
Gender filter. Uses face detection on profile photos.Valid values: "male", "female"
​
min_followers
integer
Minimum follower count (inclusive).Range: 0 to 1,000,000,000Default: none (no minimum)
​
max_followers
integer
Maximum follower count (inclusive). Useful for finding micro-influencers.Range: 0 to 1,000,000,000Default: none (no maximum)
​
limit
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). 
GET /v1/search?category=Fitness&country=US&gender=female&min_followers=10000&max_followers=100000&limit=50
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