On this page7 sections
UGC tools, creator analytics, brand monitoring and AI note-takers all want the same thing from a reel: what was said, as text they can search, quote or summarize. Instagram doesn't make that easy:
- There's no transcript endpoint. Meta's Instagram API is built for accounts that connect to your app, and it has no field for the words spoken in a reel.
- The post caption isn't the transcript. The text under a reel is whatever the creator typed, often a few words and hashtags. The spoken words are only in the audio.
- It breaks on the server. Fetching a reel can work from your laptop and then hit a login wall or a block from AWS, Fly, a Vercel function or an agent sandbox.
Doing it yourself
For reels from accounts that authorize your app, you can read the media through Meta's API, download the video and send the audio to a speech-to-text service. That stays within Instagram's terms, but it only covers accounts that connected to you. For links your users paste from anyone else, you're keeping a scraper working against Instagram's changes, a downloader, audio extraction and a speech-to-text account, and the fetch step is the part that fails on servers.
One call with Importly
Send the reel link your user pasted with "mode": "auto". If there are captions you get them; if not, speech-to-text runs in the same request. "wait": true returns the finished transcript in the response:
curl -X POST https://api.importly.io/transcribe \
-H "Authorization: Bearer $IMPORTLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/reel/<id>/",
"mode": "auto",
"wait": true,
"maxCostDollars": 0.25
}'You get the full text plus timestamped segments, so you can show the transcript next to the reel or find the moment a product was mentioned:
{
"text": "...",
"source": "importly",
"language": "en",
"duration": 139,
"data": {
"segments": [
{ "start": 0.0, "end": 3.8, "text": "..." }
]
},
"costInDollars": 0.03
}source is platform_captions when captions were used and importly when speech-to-text ran. The shape is the same either way. Details are in the transcripts docs.
A few things worth knowing:
- Public reels and video posts. Send
/reel/or/p/links to public posts. Private accounts and posts that need a login fail with a clearcode(VIDEO_PRIVATE,AUTH_REQUIRED), so you can tell the user instead of retrying. Failed transcriptions are refunded. - Other languages: pass
language, such asptores. Built-in speech-to-text assumes English unless you set it. - Long videos: if a job is still running when
waitruns out, the response has ajobId; collect the transcript withGET /transcribe/statusor awebhookUrl.
The post caption and the transcript
If you need the creator's caption, owner and stats too, POST /metadata returns them as JSON. Put that next to the transcript and you have both what the creator wrote and what they said. The Instagram scraper API page has the details.
Transcript and video together
If your app keeps the reel itself, ask for both in one import:
curl https://api.importly.io/import \
-H "Authorization: Bearer $IMPORTLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://www.instagram.com/reel/<id>/",
"includeTranscript": true,
"transcriptProvider": "importly",
"webhookUrl": "https://example.com/webhooks/import"
}'The webhook brings the MP4 and the transcript in one job.
What it costs
- Speech-to-text: $0.01 per minute of audio, fetching included, with a $0.01 minimum. A 30-second reel is $0.01; a two-and-a-half-minute one is $0.03.
- From captions, when a reel has them: $0.003.
maxCostDollarscaps a request, so an unexpectedly long video fails instead of running over.
It's free to try, no card required. See pricing.
Have your AI agent build it in
Connect https://mcp.importly.io/mcp to Claude Code, Cursor or another coding agent and ask it to add reel transcripts to your app. It gets working code for your stack, writes the integration and tests real calls with your API key, and your backend uses the same key. The steps are in Have your agent build Importly into your app.
FAQ
Does the Instagram API return reel transcripts?
No. Meta's Instagram API has no transcript or spoken-text field, and it's built around accounts that authorize your app. You get the audio and run speech-to-text yourself, or use an API that does both.
Is the reel's caption the same as its transcript?
No. The caption is the text the creator typed under the reel. The transcript is what's said in the video. Importly gives you both: the caption from /metadata and the spoken words from /transcribe.
Can I check a reel before paying for a transcript?
Yes. POST /metadata/basic returns the title and duration for $0.003, so you can confirm the link works and how long the reel is before transcribing. See the video metadata API post.
Why does my script work locally but fail on my server?
Instagram puts a lot of anonymous and datacenter traffic behind a login wall, so a fetch that works at home fails from cloud servers and sandboxes. Importly works the same from a server as from your laptop.
Related: TikTok transcript API, X video transcript API, Video transcription API.