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).
Endpoint
Section titled “Endpoint”| Method | Path | Returns |
|---|---|---|
| POST | /api/v1/instagram/post |
Post/reel details |
Request & Response
Section titled “Request & Response”Request body
Section titled “Request body”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 |
Response body
Section titled “Response body”| 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 |
Extended response (query parameters)
Section titled “Extended response (query parameters)”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 |
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.
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"const params = new URLSearchParams({ url: "https://www.instagram.com/reel/DdG4RIxIPyf/" });const res = await fetch(`https://api.megomi.my.id/api/v1/instagram/post?${params}`, { method: "POST", headers: { "x-api-key": process.env.MEGOMI_API_KEY },});const data = await res.json();import requests
res = requests.post( "https://api.megomi.my.id/api/v1/instagram/post", params={"url": "https://www.instagram.com/reel/DdG4RIxIPyf/"}, headers={"x-api-key": "YOUR_API_KEY"},)print(res.json())<?php$url = "https://api.megomi.my.id/api/v1/instagram/post?" . http_build_query(["url" => "https://www.instagram.com/reel/DdG4RIxIPyf/"]);$ch = curl_init($url);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);echo curl_exec($ch);q := url.Values{}q.Set("url", "https://www.instagram.com/reel/DdG4RIxIPyf/")req, _ := http.NewRequest("POST", "https://api.megomi.my.id/api/v1/instagram/post?"+q.Encode(), nil)req.Header.Set("x-api-key", "YOUR_API_KEY")resp, _ := http.DefaultClient.Do(req){ "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 }}{ "status": 400, "title": "Bad Request", "detail": "provide either url or shortcode" }{ "status": 404, "title": "Not Found", "detail": "the source reports no such post (deleted, or never existed); you were not charged. This answer is cached for an hour", "requestId": "req_5mPq1XwK8jVcT4nR", "finishReason": "not-found"}{ "status": 503, "title": "Service Unavailable", "detail": "no data fetched within 45s; you were not charged. The lookup is still running: submitting the same request again shortly may return it from cache, and is never charged twice", "requestId": "req_1qLr6PxV8nWtE3sJ", "finishReason": "no-data-fetched"}