GETPosts1 credit

Get post

GET https://api.instagramapi.dev/v1/post

Returns caption, media URLs, like/comment counts, author, timestamp, and carousel children for a post or reel.

Build this with an AI agent

Paste this prompt into Claude, Codex, or any coding agent.

Parameters

Name	Type	Required	Description
post	string	yes	An Instagram post/reel. Accepts a media id, a shortcode (`C1a2b3c4d5e`), or a full post/reel URL. We resolve it automatically.

Example request

curl "https://api.instagramapi.dev/v1/post?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F" \
  -H "Authorization: Bearer $INSTAGRAMAPI_KEY"

const res = await fetch("https://api.instagramapi.dev/v1/post?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F", {
  headers: { Authorization: `Bearer ${process.env.INSTAGRAMAPI_KEY}` },
});

res = requests.get("https://api.instagramapi.dev/v1/post?post=https%3A%2F%2Fwww.instagram.com%2Fp%2FC1a2b3c4d5e%2F",
    headers={"Authorization": f"Bearer {INSTAGRAMAPI_KEY}"})

Try it

Live request · uses 1 credit

API key

post *string

Example responses

Switch tabs to see the body shape for success and each error status.

{
  "data": {
    "id": "3912183471120209303",
    "shortcode": "DZK3iOsRlWX",
    "type": "photo",
    "product_type": "feed",
    "url": "https://www.instagram.com/p/DZK3iOsRlWX/",
    "caption": "Just Do It.",
    "taken_at": "2026-06-04T15:59:27Z",
    "like_count": 2499414,
    "comment_count": 55165,
    "view_count": null,
    "image_url": "https://instagram.com/.../media.jpg",
    "video_url": null,
    "video_duration": null,
    "location": null,
    "author": {
      "id": "13460080",
      "username": "nike",
      "full_name": "Nike",
      "is_verified": true,
      "is_private": false,
      "profile_pic_url": "https://instagram.com/.../nike.jpg"
    }
  },
  "meta": {
    "endpoint": "post",
    "request_id": "req_3f8a1c9e",
    "credits_charged": 1,
    "credits_remaining": 4987,
    "ms": 412
  }
}

{
  "error": {
    "code": "missing_parameter",
    "message": "Missing required parameter \"post\".",
    "docs": "/docs/post"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "invalid_api_key",
    "message": "This API key is invalid or has been revoked.",
    "docs": "/docs#authentication"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "insufficient_credits",
    "message": "You're out of credits. Top up to continue.",
    "docs": "/dashboard/billing"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "No public data for that request (private, deleted, or nonexistent). This is a billed request. We queried Instagram on your behalf.",
    "docs": "/docs/post"
  },
  "meta": {
    "request_id": "req_3f8a1c9e",
    "endpoint": "post",
    "credits_charged": 1,
    "credits_remaining": 4985
  }
}

{
  "error": {
    "code": "upstream_error",
    "message": "Upstream data provider error. You were not charged. Please retry.",
    "docs": "/docs/post"
  },
  "meta": {
    "request_id": "req_3f8a1c9e"
  }
}

Response fields

Fields returned under data on a 200 response. Every response also includes a meta object with billing info.

Field	Type	Description
id	string	Numeric post/media id.
shortcode	string	The post's shortcode, the part after /p/ in its instagram.com URL.
type	string	Media type: photo, video, or carousel.
product_type	string	More specific format (e.g. feed, clips, igtv).
url	string	Canonical instagram.com URL for the post.
caption	string	The post's caption text.
taken_at	string	When the post was published (ISO 8601, UTC).
like_count	number	Number of likes.
comment_count	number	Number of comments.
view_count	null	View count for video/reel content; null for photos.
image_url	string	URL of the post's image (cover frame for video).
video_url	null	URL of the video file; null for photos.
video_duration	null	Video length in seconds; null for photos.
location	null	Place tagged on the post, if any; null otherwise.
author	object	The account that published the post.
author.id	string	Numeric account id (stable even if the username changes).
author.username	string	The account's @handle.
author.full_name	string	Display name shown on the profile (may be empty).
author.is_verified	boolean	Whether the account has a verified badge.
author.is_private	boolean	Whether the account is private.
author.profile_pic_url	string	URL of the account's profile picture.