Instagram Profile Posts API
List a public profile's posts, newest first, with caption, likes, comments and post time. Page through with next_cursor or stop at a date.
- 1 credit per call
- Failed calls are free
- Updated
- instagram.profile-posts.list
{ "summary": { "username": "nasa", "has_more": true, "user_id": "528817151" }, "items": [ { "data": { "like_count": 163541, "comment_count": 1720, "code": "DeCPVhERA8e", "id": "3999826868370149150", "is_video": true, "like_and_view_counts_disabled": false, "media_type": 2, "original_height": 1920, "original_width": 1080, "taken_at": 1791036618, "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…" }, "owner": { "username": "astro_jessica", "id": "4092263381", "is_verified": true }, "coauthor_producers": [ { "username": "nasa", "is_verified": true }, { "username": "iss", "is_verified": true } ] } }, { "data": { "like_count": 34280, "comment_count": 258, "code": "DeCNJEyOkpq", "id": "3999817217276004970", "is_video": true, "like_and_view_counts_disabled": false, "media_type": 2, "original_height": 1920, "original_width": 1080, "taken_at": 1791035813, "caption": { "text": "From Florida to the front door in under eight hours. 🚀\n\n@nasa’s @spacex Crew-13 lifted off from Cape Canaveral, Florida, at 11:10 a.m. EDT …" }, "owner": { "username": "nasajohnson", "id": "673882723", "is_verified": true }, "coauthor_producers": [ { "username": "nasa", "is_verified": true }, { "username": "nasakennedy", "is_verified": true } ] } } ]}
| # | Caption | Account | Likes | Comments | Posted (Unix time) | Shortcode |
|---|---|---|---|---|---|---|
| 1 | Room with a view. Check out my new digs as I camp out in Dragon… | astro_jessica | 163,541 | 1720 | 1,791,036,618 | DeCPVhERA8e |
| 2 | From Florida to the front door in under eight hours. 🚀 @nasa’s … | nasajohnson | 34,280 | 258 | 1,791,035,813 | DeCNJEyOkpq |
| 3 | Swipe for countless stars Sagittarius B2 is the most massive an… | nasa | 842,854 | 3095 | 1,790,974,365 | DeAYvsnn4la |
| 4 | There’s no stopping us! NASA’s X-59 completes a record six flig… | nasaaero | 42,976 | 222 | 1,790,972,870 | DeAVuphM4C- |
| 5 | Godspeed, Crew-13. 🚀 On Thursday, Oct. 1, at 11:10 a.m. EDT (15… | nasa | 101,832 | 509 | 1,790,877,709 | Dd9gYJnDCKl |
| 6 | Meet the space travelers of Crew-13! NASA astronauts Jessica Wa… | nasa | 214,191 | 2127 | 1,790,798,794 | Dd7J2GbFx1V |
| 7 | I spy with my X-ray eyes 👀 Using @NASAChandraXray, astronomers … | nasa | 322,362 | 852 | 1,790,700,488 | Dd4OWyWjFsh |
| 8 | hey siri queue free bird 🇺🇸 | clevelandbrowns | 41,595 | 151 | 1,790,627,402 | Dd2DAyBmwvW |
| 9 | What happens when we detect an asteroid that could pose a threa… | nasa | 109,451 | 928 | 1,790,609,228 | Dd1gQBsCWE8 |
| 10 | On Saturday, Sept. 26, the first full moon of autumn will climb… | nasa | 691,267 | 1966 | 1,790,345,591 | DdtpcapjOph |
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 profile's username or URL. | https://www.instagram.com/nasa |
| cursor | string | no | Pass next_cursor from the last response, with the same profile, to get the next page. | |
| limit | integer | no | How many posts to return in this call. | |
| max_pages | integer | no | How many pages to read in this call. A smaller number answers faster. | |
| since | integer | no | Only posts from this moment on, as a Unix timestamp. Pinned posts can appear out of date order. |
Fields it returns
What each record in the response holds, with the values from the sample above.
| Field | Type | What it is | Example |
|---|---|---|---|
| items[].data.like_count | integer | Likes, as Instagram shows them. | 163,541 |
| items[].data.comment_count | integer | Comments, as Instagram shows them. | 1720 |
| items[].data.taken_at | integer | When it was posted, as a Unix time in seconds. | 1,791,036,618 |
| items[].data.code | string | The post's short code, the last part of its link. | DeCPVhERA8e |
| items[].data.caption | object | The post's caption. | 1 fields |
| items[].data | object | The post. | 13 fields |
| items[].data.coauthor_producers | array | Accounts credited as co-authors of the post. | 2 records |
| items[].data.id | string | The post's Instagram ID. | 3999826868370149150 |
| items[].data.is_video | boolean | Whether the post is a video. | true |
| items[].data.like_and_view_counts_disabled | boolean | Whether the account hides like and view counts. | false |
| items[].data.media_type | integer | Instagram's media type: 1 a photo, 2 a video, 8 a carousel. | 2 |
| items[].data.original_height | integer | The photo or video's original height, in pixels. | 1920 |
| items[].data.original_width | integer | The photo or video's original width, in pixels. | 1080 |
| items[].data.owner | object | The account that posted it. | 3 fields |
| items | array | The account's posts. | 50 records |
| summary | object | Totals and paging details for this answer. | 3 fields |
| summary.has_more | boolean | Whether more posts are available. | true |
| summary.user_id | string | The account's Instagram ID. | 528817151 |
| summary.username | string | The account's username. | nasa |
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.profile-posts.list", "input": { "url": "https://www.instagram.com/nasa" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "instagram.profile-posts.list", "input": { "url": "https://www.instagram.com/nasa" }}''')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.profile-posts.list", "input": { "url": "https://www.instagram.com/nasa" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
https://data.upscrape.com/mcp
With Upscrape, pull NASA's latest Instagram posts and make a table of caption, likes and comments. Which five posts got the most likes?
More from the Instagram API
- Instagram Profile API1 credit
- Instagram Reels API1 credit
- Instagram Post API1 credit
- Instagram Comments API1 credit
- Instagram Hashtag Posts Search API1 credit
- Instagram Hashtag Keyword Search API1 credit
- Instagram Popular Search API1 credit
- Instagram Topic Search API1 credit
- Instagram Topics API1 credit
- Instagram Profiles Search API1 credit
- Instagram Reels Search API1 credit
- Instagram Explore API1 credit
- Instagram Reels by Audio API1 credit
- Instagram Highlights API1 credit
- Instagram Saved Highlight Items API1 credit
- Instagram Basic Profile by ID API1 credit
- Instagram Location API1 credit
- Instagram Embed API1 credit
The same data from other platforms
Instagram Profile Posts API FAQ
The short answers. The docs have the long ones.
How much does the Instagram Profile Posts 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.profile-posts.list, checks its price and runs it with the same credits as the REST API.
Your first Instagram call is free.
Up to 100 free credits to start, no card needed.