Get Instagram Reel, post, or carousel detail & MP4 URL
GET/v1/instagram/post10 Credits / request($1.00 / 1K requests)· Updated 2026-11-15
GET /v1/instagram/post extracts full metadata, direct CDN MP4 video_url streams, carousel slides (carousel_media), caption text, author details, and engagement metrics (like_count, comment_count, play_count) for any public Instagram Reel, photo, or carousel post by shortcode, post URL, or media_id. Pricing is $1.00 per 1,000 lookups (10 credits/call; 0 credits on 404 or errors) with 30-minute edge caching and automatic multi-source failover.
When to Use vs. Honest Limitations
- →Temporary CDN stream signatures: Instagram MP4 and image URLs expire after several hours; persist downloaded media in your own object storage if needed for archival.
- →Single post vs. bulk Reels feed: Best for inspecting individual post URLs ($1.00/1K); use /v1/instagram/reels ($0.20/1K reels) when ingesting a creator's Reels catalog in bulk.
- →Public posts & Reels only: Deleted or private posts return 0 billable credits and cannot bypass Instagram account privacy controls.
Fetch full metadata, caption, engagement counters, carousel items (data.carousel_media), and direct CDN MP4 stream (data.video_url) for any public Instagram post or Reel by shortcode, url, or media_id. Aliases: /v1/instagram/media, /v1/instagram/posts, /v1/ig/post.
Query Parameters
shortcodestringrequiredInstagram post/Reel shortcode (e.g.
DfpU4xcsnw8) or full Instagram URL (url/media_idalso accepted).Example:
DfpU4xcsnw8
Example Request (cURL / Python / JavaScript)
curl "https://api.shortvidapi.com/v1/instagram/post?shortcode=DfpU4xcsnw8" \
-H "x-api-key: tk_your_api_key"Live Response Preview
{
"code": 0,
"provider": "https://shortvidapi.com",
"status": "ok",
"msg": "success",
"data": {
"id": "4028843203975347260",
"shortcode": "DfpU4xcsnw8",
"url": "https://www.instagram.com/reel/DfpU4xcsnw8/",
"reel_url": "https://www.instagram.com/reel/DfpU4xcsnw8/",
"type": "reel",
"is_video": true,
"caption": "Faster times are in the air.\n\nEngineered for enhanced energy return to unlock your next personal best. The Nike Alphafly 4 is available now.",
"play_count": null,
"view_count": null,
"like_count": 72252,
"comment_count": 349,
"video_url": "https://instagram.fdet3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQMcjEcCZDs26JuPcBju_GK1DYEWfPuej25wyK60i2AcrrD_4E889GDDOEpfRkAJ1pAduQMPa5TuajI0FEV9x9qxfmulrzGaTiyIA90.mp4?_nc_cat=101&_nc_oc=AdoVksrQAY1-yDRj3bNJNuAIXDG5RrfNdAlFGX...",
"thumbnail_url": "https://instagram.fdet3-1.fna.fbcdn.net/v/t51.82787-15/902585854_1428840322731687_659916410608363300_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=1&ig_cache_key=NDAyODg0MzIwMzk3NTM0NzI2MDE0Mjg4NDAzMTYwNjUwMjE%3D.3-ccb7-5&ccb=7-5&_n...",
"taken_at": 1794495604,
"created_at": "2026-11-12T15:00:04.000Z",
"is_pinned": false,
"is_paid_partnership": false,
"owner": {
"id": "13460080",
"username": "nike",
"full_name": "Nike",
"is_verified": true,
"profile_pic_url": "https://scontent.cdninstagram.com/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ig_cache_key=GKTg4CAx7dmBvPZBABvIoQw1-sEPbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=6..."
}
}
}Response Fields
Success (code === 0). Charged according to the endpoint credit rate.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | Example: https://shortvidapi.com |
status | string | Example: ok |
msg | string | Example: success |
data | object | |
id | string | Example: 4028843203975347260 |
shortcode | string | Example: DfpU4xcsnw8 |
url | string | Example: https://www.instagram.com/reel/DfpU4xcsnw8/ |
reel_url | string | Example: https://www.instagram.com/reel/DfpU4xcsnw8/ |
type | string | Example: reel |
is_video | boolean | Example: true |
caption | string | Example: Faster times are in the air. Engineered for enhanced energy |
play_count | string | |
view_count | string | |
like_count | integer | Example: 72252 |
comment_count | integer | Example: 349 |
video_url | string | Example: https://instagram.fdet3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQMcj |
thumbnail_url | string | Example: https://instagram.fdet3-1.fna.fbcdn.net/v/t51.82787-15/90258 |
taken_at | integer | Example: 1794495604 |
created_at | string | Example: 2026-11-12T15:00:04.000Z |
is_pinned | boolean | Example: false |
is_paid_partnership | boolean | Example: false |
owner | object | |
id | string | Example: 13460080 |
username | string | Example: nike |
full_name | string | Example: Nike |
is_verified | boolean | Example: true |
profile_pic_url | string | Example: https://scontent.cdninstagram.com/v/t51.82787-19/551608484_1 |
Status Codes
- 200
- Success (
code === 0). Charged according to the endpoint credit rate. - 400
- Invalid parameters, or API key placed in the URL query string (not charged).
- 401
- Missing or invalid
x-api-keyheader (not charged). - 402
- Insufficient credit balance (not charged).
- 403
- Account disabled (not charged).
- 404
- Unknown endpoint or disabled unstable endpoint (not charged).
- 405
- Method not allowed — all
/v1/*data endpoints useGET(not charged). - 429
- Rate limit exceeded (not charged). Respect the
Retry-Afterheader. - 503
- Temporary upstream or gateway error (not charged). Retry with exponential backoff.
Migrating from direct scraping and hitting HTTP 403 Forbidden or empty responses on www.tiktok.com? Read How to Fix TikTok HTTP Error 403 or compare quota limits in our TikTok API Quota & Cost Calculator.