BlogCore API

Instagram Reel Download API: Get the Video From a Reel Link

Let users paste a public Instagram reel link and get the video file in your app, from servers and serverless functions. One request, a webhook, code and cost.

On this page6 sections

Short answer: Instagram's official API only gives you media from accounts that connect to your app. To let users paste any public reel link and get the video file, send the link to a media API like Importly: one request, and you get a link to the MP4 (or a copy in your own bucket) plus the title and duration. It works from servers and serverless functions, where fetching Instagram yourself usually hits a login wall.

Last checked: November 21, 2026.

Why reel downloads are hard to build yourself

The feature sounds small: a user pastes https://www.instagram.com/reel/<id>/ and your app saves the video. Building it runs into a few walls:

  • The official API is for connected accounts. Meta's Instagram API lets an account that authorizes your app read its own media. It doesn't fetch a reel from a link someone else posted.
  • Anonymous requests hit login walls. Instagram asks for a login more and more often, and it blocks requests from cloud and datacenter IPs first. So the scraper that works on your laptop fails on AWS, Fly or a Vercel function.
  • Scrapers go stale. Page structure and media URLs change, and open-source scrapers break until someone patches them. That someone becomes you.
  • Downloads outlive short functions. A request handler that downloads video can run into the serverless timeout.

One request with Importly

Send the reel link from your backend. The same endpoint takes /reel/ and /p/ links:

bash
curl -X POST https://api.importly.io/import \
  -H "Authorization: Bearer $IMPORTLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.instagram.com/reel/<id>/",
    "videoQuality": "720p",
    "webhookUrl": "https://your-app.example.com/api/importly-webhook"
  }'

You get a jobId back right away. When the job finishes, Importly sends one POST to your webhookUrl:

json
{
  "success": true,
  "data": {
    "jobId": "a824760e-ece1-4415-8838-ce2a7785ea6b",
    "type": "import",
    "status": "completed",
    "mediaUrl": "https://storage.example.com/imports/a824760e-…/reel.mp4?X-Amz-…",
    "title": "...",
    "duration": 31,
    "costInDollars": 0.01
  }
}

mediaUrl is a signed link that lasts 7 days, so copy the file somewhere permanent, or set store: true to have every import copied to your S3 or R2 bucket. Reels are portrait, and 720p means 720 pixels on the short side, so you get 720×1280.

In a Node backend, the webhook handler is a few lines:

ts
// app/api/importly-webhook/route.ts (Next.js)
export async function POST(req: Request) {
  const { success, data } = await req.json()
  if (!success) {
    console.error('Reel import failed', data.code, data.message)
    return new Response('ok')
  }
  await saveReel({ jobId: data.jobId, url: data.mediaUrl, title: data.title, duration: data.duration })
  return new Response('ok')
}

Webhook deliveries aren't retried, so keep a polling fallback on GET /import/status?id=<jobId>. The Next.js recipe has both.

Audio only, transcripts and details

  • Audio only: add "includeVideo": false to get just the sound, for music or voice-over features.
  • Transcript: send the same link to POST /transcribe with "mode": "auto" to get what was said, using captions when there are some and speech-to-text when there aren't. See Instagram reel transcript API.
  • Details: POST /metadata returns the owner, caption, duration and engagement counts as JSON, without downloading the video.

What it costs

Downloads are $2.05 per GB with a $0.01 minimum, so a typical 30-second reel costs a cent or two. Failed imports are free. It's free to try, no card required (pricing).

What won't work

Importly fetches what's public. Private accounts, close-friends stories and anything that needs a login fail with VIDEO_PRIVATE or AUTH_REQUIRED and aren't charged. The full list is on supported sites. Only download reels your users have the right to use.

FAQ

Is there an official Instagram API to download reels?

Only for accounts that authorize your app, through Meta's Instagram API. For public reel links from any account, you need your own scraper or a media API.

Does it work from a serverless function?

Yes. The request returns a job id right away, and the download happens on Importly's side, so it doesn't race your function's timeout. You get the result by webhook or by polling.

Keep reading

Put video and audio links to work in your app

One API for files, transcripts and metadata. Free to try, no card required.

Try free →