Instagram

Get an Instagram profile

GET

/api/v1/instagram/profiles/{identity}

Path parameters

identity

required

string

Username, provider id, or profile URL

Query parameters

connectedAccountId

required

string · uuid

Connected account to act as

Response

200Instagram profile.

profile

object

username

string | null

profileUrl

string | null

firstName

string | null

lastName

string | null

fullName

string | null

biography

string | null

location

string | null

imageUrl

string | null

imageUrlLarge

string | null

backgroundImageUrl

string | null

followerCount

number | null

followRequestPending

boolean

A follow request awaiting an answer; only private accounts can be in this state.

isFollowing

boolean

This account already follows them.

remainingToday

integer

Errors

  • 400: Bad request
  • 401: Unauthorized: missing or invalid API key
  • 403: Forbidden
  • 404: Not found
  • 422: Invalid request payload

Search docs

Search documentation, API reference, and MCP tools

We use cookies to enhance your experience on Needle and keep your data secure. Privacy Policy