Skip to main content

Success response (200)

A successful request returns a JSON object with results (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: 150000
integer
required
Number of accounts this user follows. Example: 900
string
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: false
boolean
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: true
integer
Total number of posts on the account. Useful for gauging activity level. Example: 523
string
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.
Your x402 client library handles this automatically — you don’t need to parse this response manually.

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 the Retry-After header.

500 Internal Server Error

Unexpected server error. If you see this consistently, please report it at github.com/socialinteldev/social-intel-mcp/issues.