Instagram

List the posts of an account

Returns the posts of one account, most recent first. A username that does not exist comes back with no posts rather than an error.

GET

/api/v1/instagram/posts

Query parameters

connectedAccountId

required

string · uuid

Connected account to act as

identity

required

string

Whose posts to read, as a username without @.

cursor

optional

string

limit

optional

integer

Page size, up to 100. Defaults to 20. A page can hold fewer, so follow cursor until it comes back null.

Response

200Posts.

posts

object[]

cursor

string | null

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