POST /api/v1/instagram/profile — 1 credit per request
Look up an Instagram profile by URL or handle. Returns identity, status flags, counts, bio links, the most recent grid posts, and a set of derived metrics.
Endpoint
Section titled “Endpoint”| Method | Path | Returns |
|---|---|---|
| POST | /api/v1/instagram/profile |
Profile details |
Request & Response
Section titled “Request & Response”Request body
Section titled “Request body”Provide either url or handle — exactly one is required.
| Name | Type | Required | Description |
|---|---|---|---|
url |
string | One of url or handle |
An instagram.com profile URL, e.g. https://www.instagram.com/<handle>/ |
handle |
string | One of url or handle |
Instagram username, with or without a leading @ |
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 |
handle |
string | Resolved handle |
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 profile |
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 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 (handle doesn’t exist), 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/profile" \ -H "x-api-key: YOUR_API_KEY" \ -H "content-type: application/json" \ -d '{"handle": "nasa"}'const res = await fetch("https://api.megomi.my.id/api/v1/instagram/profile", { method: "POST", headers: { "x-api-key": process.env.MEGOMI_API_KEY, "content-type": "application/json", }, body: JSON.stringify({ handle: "nasa" }),});const data = await res.json();import requests
res = requests.post( "https://api.megomi.my.id/api/v1/instagram/profile", json={"handle": "nasa"}, headers={"x-api-key": "YOUR_API_KEY"},)print(res.json()){ "requestId": "req_9f1kQ3zP7mLxA2dR", "handle": "nasa", "status": "success", "coalesced": false, "cached": false, "result": { "id": "528817151", "fbid": "17841401474538262", "username": "nasa", "fullName": "NASA", "biography": "Making the seemingly impossible, possible. ✨", "profilePicUrl": "https://scontent.cdninstagram.com/v/stub.jpg", "externalUrl": "https://www.nasa.gov", "isVerified": true, "isPrivate": false, "isMemorialized": false, "followerCount": 104338012, "followingCount": 91, "bioLinks": [ { "title": "NASA.gov Homepage", "url": "https://www.nasa.gov", "lynxUrl": "https://l.instagram.com/?u=https%3A%2F%2Fwww.nasa.gov%2F&e=STUB", "linkType": "external" }, { "title": "NASA Internships", "url": "http://intern.nasa.gov", "lynxUrl": "https://l.instagram.com/?u=https%3A%2F%2Fintern.nasa.gov%2F&e=STUB", "linkType": "external" }, { "title": "MAX POWER", "url": "https://www.nasa.gov/maxpower", "lynxUrl": "https://l.instagram.com/?u=https%3A%2F%2Fwww.nasa.gov%2Fmaxpower&e=STUB", "linkType": "external" } ], "hasClips": true, "latestStoryAt": "2026-09-23T16:25:26Z", "highlightReelCount": 2, "hasThreadsBadge": true, "threadsUsername": "nasa", "recentPosts": [ { "shortcode": "DdHyaYAifb6", "mediaId": "3983374110243288826", "type": "carousel", "productType": "carousel_container", "takenAt": "2026-09-10T21:20:19Z", "caption": "Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the", "accessibilityCaption": "Photo by NASA on September 10, 2026. May be an image of text.", "displayUrl": "https://scontent.cdninstagram.com/v/stub.jpg", "carouselMediaCount": 4, "owner": { "id": "528817151", "username": "nasa" }, "pinnedInferred": true }, { "shortcode": "DdofGP3DO3X", "mediaId": "3992577838452370903", "type": "photo", "productType": "feed", "takenAt": "2026-09-23T14:06:29Z", "caption": "This galaxy is a little extra.\n\nYou’re looking at Messier 106, a spiral galaxy with an extra set of arms. These two additional arms are made", "accessibilityCaption": "Photo by NASA on September 23, 2026. May be an image of outer space and text.", "displayUrl": "https://scontent.cdninstagram.com/v/stub.jpg", "owner": { "id": "528817151", "username": "nasa" } }, { "shortcode": "DdmGYEUl9xu", "mediaId": "3991906161897495662", "type": "photo", "productType": "feed", "takenAt": "2026-09-22T15:51:59Z", "caption": "\"Autumn is a second spring when every leaf is a flower.\"\n\nSept. 22 is the fall equinox, when autumn begins in the Northern Hemisphere, sprin", "accessibilityCaption": "Photo by NASA on September 22, 2026. May be art of text.", "displayUrl": "https://scontent.cdninstagram.com/v/stub.jpg", "owner": { "id": "528817151", "username": "nasa" } } ], "recentPostsHasMore": true, "recentReels": [ { "shortcode": "Dd1gQBsCWE8", "mediaId": "3996242083173720380", "takenAt": "2026-09-28T15:26:41Z", "likeCount": 89263, "commentCount": 768, "instagramPlayCount": 4438886, "dimensions": { "height": 1080, "width": 608 }, "ownerId": "528817151" }, { "shortcode": "DdhFkS7KGkZ", "mediaId": "3990495229280545049", "takenAt": "2026-09-20T17:08:42Z", "likeCount": 46740, "commentCount": 595, "instagramPlayCount": 7173588, "dimensions": { "height": 1920, "width": 1080 }, "ownerId": "231432514", "coauthorIds": [ "59096690402", "528817151" ], "isCollab": true }, { "shortcode": "DdRyQxKteC1", "mediaId": "3986188199829823669", "takenAt": "2026-09-14T18:31:25Z", "likeCount": 233513, "commentCount": 2428, "instagramPlayCount": 9797219, "dimensions": { "height": 1584, "width": 892 }, "ownerId": "4092263381", "coauthorIds": [ "528817151", "953293389", "50101577629" ], "isCollab": true } ], "recentReelsHasMore": true, "recentReelsAsOf": "2026-09-30T07:05:00Z", "metrics": { "followerToFollowingRatio": 1146571.56, "hasExternalWebsite": true, "externalLinkDomains": [ "nasa.gov" ], "hasActiveStory": false, "sample": { "posts": 6, "withTimestamp": 6, "pinnedInferred": 3, "postsFromOtherOwners": 2, "hasMore": true }, "mediaTypeBreakdown": { "photos": { "count": 4, "percent": 66.67 }, "videos": { "count": 0, "percent": 0 }, "carousels": { "count": 2, "percent": 33.33 } }, "reelSharePercent": 0, "postsPerWeek": 7.78, "lastPostedAt": "2026-09-23T14:06:29Z", "isActive": true, "topMentions": [ { "username": "astro_jessica", "count": 1 }, { "username": "iss", "count": 1 } ], "avgCaptionLengthChars": 140, "reels": { "sampledReels": 12, "reelsWithPlays": 12, "collabReels": 10, "avgInstagramPlays": 5544740.83, "medianInstagramPlays": 5435537, "avgLikes": 120561, "medianLikes": 101481.5, "avgComments": 933.42, "medianComments": 681.5, "playsPerFollowerPercent": 5.31, "likesPerPlayPercent": 2.17, "countsSource": "public-reels-feed" } }, "metricsAvailability": { "engagement": { "status": "unavailable", "reason": "insufficient-coverage", "coverage": { "covered": 0, "of": 6 } }, "engagementByFormat": { "status": "unavailable", "reason": "insufficient-coverage", "coverage": { "covered": 0, "of": 6 } }, "instagramPlays": { "status": "available", "source": "public-reels-feed", "asOf": "2026-09-30T07:05:00Z", "coverage": { "covered": 12, "of": 12 } }, "perPostCounts": { "status": "unavailable", "reason": "not-returned-by-source", "coverage": { "covered": 0, "of": 6 } }, "reelStats": { "status": "available", "source": "public-reels-feed", "asOf": "2026-09-30T07:05:00Z", "coverage": { "covered": 12, "of": 12 } }, "topPost": { "status": "unavailable", "reason": "insufficient-coverage", "coverage": { "covered": 0, "of": 6 } }, "totalPlays": { "status": "unavailable", "reason": "requires-authenticated-session" } } }, "finishReason": ""}{ "status": 400, "title": "Bad Request", "detail": "provide either url or handle" }{ "status": 404, "title": "Not Found", "detail": "the source reports no such profile (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"}