Instagram API · Endpoint

Instagram Post API

Q: What do I send?

Send url. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds instagram.post.get, checks its price and runs it with the same credits as the REST API.

Get one post, reel or carousel from its link or shortcode: author, caption, media and the engagement counts Instagram shows.

1 credit per call
Failed calls are free
Updated 12 Oct 2026
instagram.post.get

Start free, 100 credits API reference

Response completed

{  "data": {    "like_count": 163633,    "comment_count": 1720,    "author_id": 4092263381,    "author_name": "astro_jessica",    "author_url": "https://www.instagram.com/astro_jessica",    "code": "DeCPVhERA8e",    "has_audio": true,    "height": null,    "id": "3999826868370149150",    "like_and_view_counts_disabled": false,    "media_id": "3999826868370149150",    "media_type": 2,    "original_height": 1920,    "original_width": 1080,    "product_type": "clips",    "provider_name": "Instagram",    "provider_url": "https://www.instagram.com",    "rich_data_available": true,    "taken_at": 1791036618,    "thumbnail_height": 1137,    "thumbnail_width": 640,    "type": "rich",    "version": "1.0",    "width": 658,    "caption": {      "text": "Room with a view. Check out my new digs as I camp out in Dragon until our departure. With Crew-13’s arrival we have a very full house on th…",      "created_at": 1791036617    },    "coauthor_producers": [      {        "full_name": "NASA",        "username": "nasa",        "id": "528817151",        "is_verified": true      },      {        "full_name": "International Space Station",        "username": "iss",        "id": "953293389",        "is_verified": true      }    ]  }}

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
url	string	yes	The post or reel link, or its 11-character shortcode. Use the full link for older posts.	DeCPVhERA8e

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
data.coauthor_producers[].full_name	string		NASA
data.coauthor_producers[].username	string		nasa
data.coauthor_producers[].id	string	The co-author's Instagram ID.	528817151
data.coauthor_producers[].is_verified	boolean		true
data	object	The post.	26 fields
data.caption.text	string	The caption text.	Room with a view. Check out my new digs as I camp out in Dragon…
data.author_name	string	The username of the account that posted it.	astro_jessica
data.like_count	integer	Likes, as Instagram shows them.	163,633
data.comment_count	integer	Comments, as Instagram shows them.	1720
data.taken_at	integer	When it was posted, as a Unix time in seconds.	1,791,036,618
data.code	string	The post's short code, the last part of its link.	DeCPVhERA8e
data.media_type	integer	Instagram's media type: 1 a photo, 2 a video, 8 a carousel.	2
data.author_id	integer	The posting account's Instagram ID.	4,092,263,381
data.author_url	string	Link to the posting account.	https://www.instagram.com/astro_jessica
data.caption	object	The post's caption.	2 fields
data.caption.created_at	integer	When the caption was written, as a Unix time in seconds.	1,791,036,617
data.coauthor_producers	array	Accounts credited as co-authors of the post.	2 records
data.has_audio	boolean	Whether the video has sound.	true
data.height	null	Height of the embed, in pixels, when given.	null
data.id	string	The post's Instagram ID.	3999826868370149150
data.like_and_view_counts_disabled	boolean	Whether the account hides like and view counts.	false
data.media_id	string	The ID of the photo or video.	3999826868370149150
data.original_height	integer	The photo or video's original height, in pixels.	1920
data.original_width	integer	The photo or video's original width, in pixels.	1080
data.product_type	string	Instagram's kind of post; clips is a reel.	clips
data.provider_name	string	Who provides the embed: Instagram.	Instagram
data.provider_url	string	Instagram's address.	https://www.instagram.com
data.rich_data_available	boolean		true
data.thumbnail_height	integer	Height of the thumbnail image, in pixels.	1137
data.thumbnail_width	integer	Width of the thumbnail image, in pixels.	640
data.type	string	The embed type.	rich
data.version	string	The embed format's version.	1.0
data.width	integer	Width of the embed, in pixels.	658

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "instagram.post.get",  "input": {    "url": "DeCPVhERA8e"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "instagram.post.get",  "input": {    "url": "DeCPVhERA8e"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "instagram.post.get",  "input": {    "url": "DeCPVhERA8e"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

In your AI agent Claude · Cursor · any MCP client

1Add the Upscrape MCP server

https://data.upscrape.com/mcp

2Ask for the data in plain words

With Upscrape, open the Instagram reel with shortcode DeCPVhERA8e and tell me who posted it, when, and what the caption says.

The agent finds the endpoint, shows you the price, and runs it with your credits.

Instagram

More from the Instagram API

Same data, other platforms

The same data from other platforms

Questions

Instagram Post API FAQ

The short answers. The docs have the long ones.

Still have a question? Talk to the people who build the endpoints.

Book a call [email protected]

How much does the Instagram Post API cost?

1 credit per successful call, shown before it runs. You buy credits once, and paid credits never expire.

What do I send?

Send url. The input fields below list every option with its type and limits.

Do I need an Instagram login?

No. It reads public Instagram data; nothing runs on your account.

Can my AI agent call it?

Yes, over MCP: the agent finds instagram.post.get, checks its price and runs it with the same credits as the REST API.

Get started

Your first Instagram call is free.

Up to 100 free credits to start, no card needed.

Start building for free Book a call