Instagram

Get an Instagram post

Returns one post, by postId or by the short code from its URL.

GET

/api/v1/instagram/posts/{postId}

Path parameters

postId

required

string

postId from a posts listing, or the short code from the post URL.

Query parameters

connectedAccountId

required

string · uuid

Connected account to act as

Response

200Post.

post

object

postId

string

Pass as postId to comment on the post or read its likes.

shortcode

string | null

The id in the post URL, as in instagram.com/p/{shortcode}.

text

string

The caption, empty when the post carries none.

url

string | null

postedAt

string · date-time | null

likeCount

number | null

commentCount

number | null

hasLiked

boolean

True when the connected account already liked the post.

commentsDisabled

boolean

True when the post accepts no comments.

mediaType

"image" | "video" | null

previewImageUrl

string | null

videoUrl

string | null

locationName

string | null

author

object | null

identity

string | null

Username, taken as identity by the other endpoints.

imageUrl

string | null

isVerified

boolean

isPrivate

boolean

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