Success response (200)
A successful request returns a JSON object withresults (array) and count (integer).
Field reference
Top-level fields
array
required
Array of influencer objects matching the search criteria.
integer
required
Number of results returned. May be less than
limit if fewer matches exist.Influencer object fields
string
required
Instagram handle (without @). Example:
"fitnessguru"string
required
Display name on the Instagram profile. Example:
"Alex Fitness"integer
required
Total follower count. Example:
150000integer
required
Number of accounts this user follows. Example:
900string
Instagram business category. Only present for business/creator accounts. Example:
"Fitness"string
Profile bio text. May contain line breaks and emojis. Example:
"Personal trainer | Online coaching | NYC"string
Public contact email. Only present on business accounts that have set a public email. This is the highest-value field for outreach use cases. Example:
"alex@fitnessguru.com"boolean
required
Whether the account has a verified (blue badge) checkmark. Example:
falseboolean
required
Whether the account is a business or creator account (as opposed to personal). Business accounts are more likely to have
public_email and category. Example: trueinteger
Total number of posts on the account. Useful for gauging activity level. Example:
523string
Predicted gender of the account holder. Values:
"male" or "female". Based on profile analysis. Example: "female"Error responses
402 Payment Required
Returned on every initial request. Contains payment details for x402 clients.422 Validation Error
Returned when request parameters are invalid.429 Too Many Requests
Returned when rate limits are exceeded. Retry after the duration specified in theRetry-After header.