Skip to content

Instagram Post Info

POST /api/v1/instagram/post — 1 credit per request

Look up an Instagram post or reel by URL or shortcode. Returns caption, counts, media, owner, tags, and derived engagement/velocity metrics. Send it in the JSON body, or as query parameters to get the extended response (see below).

Method Path Returns
POST /api/v1/instagram/post Post/reel details

Provide either url or shortcode — exactly one is required.

Name Type Required Description
url string One of url or shortcode An instagram.com post/reel URL, e.g. https://www.instagram.com/p/<shortcode>/ or /reel/<shortcode>/
shortcode string One of url or shortcode The post shortcode directly
Field Type Description
requestId string Opaque ID for this request (req_…). Keep it if you plan to resubmit later
shortcode string Resolved post shortcode
status string "success" — the only value a 200 response carries
coalesced boolean true if this request attached to an already-in-flight job for the same post
cached boolean true if served from a fresh, previously-scraped result. Free if your key already paid for this target in the last 10 minutes; charged otherwise
result object See fields below
finishReason string An empty string on a freshly fetched answer, absent on a cached one. Ignore it on a 200

The post can also be named in the query string, with no body: ?url=https://www.instagram.com/p/<shortcode>/. Using any of the parameters below, even set to false, switches the response to the extended form. Send the post either in the query or in the body, never both (400).

Name Type Description
url string The post or reel URL, same rules as the body’s url
region string A two-letter country code (US, GB, …). Checked (400 otherwise) and then ignored: there is no per-country routing
trim boolean A smaller data.xdt_shortcode_media, and no extensions
download_media boolean Store the post’s media and return permanent links to it in place of Instagram’s expiring ones. Costs 9 credits more (10 in all) and only when every file was stored. Available only when the service has it switched on; otherwise it is ignored and costs nothing extra

The extended response keeps every field above, except that status is "ok", and adds:

Field Type Description
success boolean Always true on a 200
credits_charged integer Credits this request cost; 0 for a post your key already paid for. Includes the download_media add-on when one was charged
credits_remaining integer Your balance after this request
cached_at string When a cached answer was fetched. Cached answers only
data.xdt_shortcode_media object The post in Instagram’s own web field names (shortcode, display_url, video_url, video_play_count, owner, edge_media_to_caption, edge_media_preview_like, edge_sidecar_to_children for a carousel, …). A field Instagram did not give is absent, never 0 or false
extensions object Always {"is_final": true}. Absent with trim=true
Terminal window
curl -X POST "https://api.megomi.my.id/api/v1/instagram/post?url=https://www.instagram.com/p/DdG4RIxIPyf/&trim=true" \
-H "x-api-key: YOUR_API_KEY"

The submit waits for its job to finish, up to 45 seconds, and answers as soon as a result is ready. Only a 200 is ever charged. Otherwise you get 404 (post doesn’t exist / deleted / private), 403 (blocked by Instagram), or 503 (no data fetched in time) — none of which are charged. Resubmitting the same target either way attaches to the still-in-flight job or returns the by-then-resolved result inline, at no extra charge.

Terminal window
curl -X POST "https://api.megomi.my.id/api/v1/instagram/post?url=https://www.instagram.com/reel/DdG4RIxIPyf/" \
-H "x-api-key: YOUR_API_KEY"
{
"requestId": "req_9f1kQ3zP7mLxA2dR",
"shortcode": "DdG4RIxIPyf",
"status": "ok",
"coalesced": false,
"cached": false,
"result": {
"shortcode": "DdG4RIxIPyf",
"mediaId": "3983118388705688735",
"productType": "clips",
"isVideo": true,
"caption": "Presented by @Rolex. Welcome to Africa 🌍 Africa Earth’s Wild",
"takenAt": "2026-09-10T13:00:14Z",
"likeCount": 77870,
"commentCount": 510,
"hasAudio": true,
"likeAndViewCountsDisabled": false,
"displayUrl": "https://scontent.cdninstagram.com/stub/4.jpg",
"thumbnailUrl": "https://scontent.cdninstagram.com/stub/4.jpg",
"videoUrl": "https://scontent.cdninstagram.com/stub/8.mp4",
"dimensions": {
"height": 1920,
"width": 1080
},
"displayResources": [
{
"url": "https://scontent.cdninstagram.com/stub/6.jpg",
"width": 1080,
"height": 1920
},
{
"url": "https://scontent.cdninstagram.com/stub/7.jpg",
"width": 720,
"height": 1280
}
],
"owner": {
"username": "natgeo",
"userId": "787132",
"isVerified": true,
"avatarUrl": "https://scontent.cdninstagram.com/stub/1.jpg",
"fullName": "National Geographic",
"isPrivate": false,
"isUnpublished": false
},
"taggedUsers": [
{
"username": "rolex",
"userId": "1165531538",
"fullName": "ROLEX"
}
],
"mentions": [
"rolex"
],
"accessibilityCaption": "Video by National Geographic on September 10, 2026. May be a",
"captionIsEdited": false,
"topics": [
{
"id": "national-geographic-africa",
"name": "national geographic africa"
},
{
"id": "nature-cinematography",
"name": "nature cinematography"
}
],
"coauthors": [
{
"username": "rolex",
"userId": "1165531538",
"fullName": "ROLEX"
}
],
"metricsAvailability": {
"engagementRateVsFollowers": {
"status": "unavailable",
"reason": "owner-profile-unavailable"
},
"engagementRateVsPlays": {
"status": "unavailable",
"reason": "requires-authenticated-session"
},
"instagramPlays": {
"status": "unavailable",
"reason": "requires-authenticated-session"
},
"instagramPlaysPerHour": {
"status": "unavailable",
"reason": "requires-authenticated-session"
},
"ownerFollowerCount": {
"status": "unavailable",
"reason": "owner-profile-unavailable"
},
"playsPerHour": {
"status": "unavailable",
"reason": "requires-authenticated-session"
},
"videoPlays": {
"status": "unavailable",
"reason": "requires-authenticated-session"
}
}
},
"finishReason": "",
"success": true,
"credits_charged": 1,
"credits_remaining": 249,
"data": {
"xdt_shortcode_media": {
"id": "3983118388705688735",
"shortcode": "DdG4RIxIPyf",
"__typename": "XDTGraphVideo",
"thumbnail_src": "https://scontent.cdninstagram.com/stub/4.jpg",
"display_url": "https://scontent.cdninstagram.com/stub/4.jpg",
"video_url": "https://scontent.cdninstagram.com/stub/8.mp4",
"has_audio": true,
"accessibility_caption": "Video by National Geographic on September 10, 2026. May be a",
"product_type": "clips",
"is_video": true,
"owner": {
"id": "787132",
"username": "natgeo",
"is_verified": true,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/1.jpg",
"full_name": "National Geographic",
"is_private": false,
"is_unpublished": false
},
"edge_media_to_caption": {
"edges": [
{
"node": {
"created_at": "1789045212",
"text": "Presented by @Rolex. Welcome to Africa 🌍 Africa Earth’s Wild",
"id": "17872894143634165"
}
}
]
},
"edge_media_to_parent_comment": {
"count": 510,
"edges": [
{
"node": {
"id": "18000000000000001",
"text": "comment 1",
"created_at": 1790834075,
"owner": {
"id": "9000000001",
"username": "commenter_1",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/10.jpg"
},
"edge_liked_by": {
"count": 0
}
}
},
{
"node": {
"id": "18000000000000002",
"text": "comment 2",
"created_at": 1790770702,
"owner": {
"id": "9000000002",
"username": "commenter_2",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/11.jpg"
},
"edge_liked_by": {
"count": 0
}
}
},
{
"node": {
"id": "18000000000000003",
"text": "comment 3",
"created_at": 1790735960,
"owner": {
"id": "9000000003",
"username": "commenter_3",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/12.jpg"
},
"edge_liked_by": {
"count": 0
}
}
}
]
},
"edge_media_preview_comment": {
"count": 510,
"edges": [
{
"node": {
"id": "18000000000000001",
"text": "comment 1",
"created_at": 1790834075,
"owner": {
"id": "9000000001",
"username": "commenter_1",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/10.jpg"
},
"edge_liked_by": {
"count": 0
}
}
},
{
"node": {
"id": "18000000000000002",
"text": "comment 2",
"created_at": 1790770702,
"owner": {
"id": "9000000002",
"username": "commenter_2",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/11.jpg"
},
"edge_liked_by": {
"count": 0
}
}
},
{
"node": {
"id": "18000000000000003",
"text": "comment 3",
"created_at": 1790735960,
"owner": {
"id": "9000000003",
"username": "commenter_3",
"is_verified": false,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/12.jpg"
},
"edge_liked_by": {
"count": 0
}
}
}
]
},
"taken_at_timestamp": 1789045214,
"edge_media_preview_like": {
"count": 77870
},
"__isXDTGraphMediaInterface": "XDTGraphVideo",
"dimensions": {
"height": 1920,
"width": 1080
},
"display_resources": [
{
"src": "https://scontent.cdninstagram.com/stub/6.jpg",
"config_width": 1080,
"config_height": 1920
},
{
"src": "https://scontent.cdninstagram.com/stub/7.jpg",
"config_width": 720,
"config_height": 1280
}
],
"caption_is_edited": false,
"like_and_view_counts_disabled": false,
"created_at": "2026-09-10T13:00:14.000Z",
"edge_media_to_tagged_user": {
"edges": [
{
"node": {
"user": {
"id": "1165531538",
"username": "rolex",
"full_name": "ROLEX",
"is_verified": true,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/9.jpg"
}
}
}
]
},
"coauthor_producers": [
{
"id": "1165531538",
"username": "rolex",
"full_name": "ROLEX",
"is_verified": true,
"profile_pic_url": "https://scontent.cdninstagram.com/stub/3.jpg"
}
]
}
},
"extensions": {
"is_final": true
}
}