On this page5 sections
If your app works with podcasts (show notes, search across episodes, clips, summaries, RAG over a back catalog), you need a transcript for an episode someone links to, and podcasts make that harder than video:
- There are no captions. Most episodes ship as an audio file and nothing else. A transcript means fetching the audio and running speech-to-text on it.
- The link isn't the file. Users paste an Apple Podcasts page or a show's website. You have to resolve that to the episode's audio, and the audio URL in the RSS feed often goes through several tracking redirects before the actual MP3.
- Episodes are long. An hour of audio is 50 MB or more, and transcribing it takes longer than a normal HTTP request, so you need a job queue, retries and a way to tell your user it's done.
- Two vendors to wire up. One piece of code fetches the audio, another sends it to a speech-to-text account, and you pay for, monitor and fix both.
Doing it yourself
If you already have the episode's MP3 and a speech-to-text account, you can download the file, upload it to the provider and poll for the result. That's a fine route for your own show or a fixed list of feeds. What it costs you is the glue: resolving Apple Podcasts pages and redirect chains, storing large files, handling timeouts, and keeping it working when a host changes something.
One call with Importly
Send Importly the episode link your user pasted, either the Apple Podcasts episode page or the MP3 from the feed, and get a timestamped transcript back:
curl -X POST https://api.importly.io/transcribe \
-H "Authorization: Bearer $IMPORTLY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://podcasts.apple.com/us/podcast/<show>/id<show-id>?i=<episode-id>",
"mode": "auto",
"maxCostDollars": 1,
"webhookUrl": "https://your.app/webhooks/transcript"
}'The response has a jobId. When the transcript is ready, Importly posts it to your webhook (or you poll GET /transcribe/status?id=<jobId>): the full text, timestamped segments, the detected language, the duration and costInDollars.
A few things worth knowing:
mode: "auto"uses the episode's own captions in the rare case there are some, and AI speech-to-text when there aren't, which for podcasts is nearly always.- Use a webhook for full episodes.
"wait": truereturns the transcript in the response, but it holds the request for 60 seconds at most. That's enough for a short clip, not for an hour-long episode. With a webhook you don't keep a connection open. maxCostDollarscaps what one episode can cost. A three-hour episode over your cap fails withMAX_COST_EXCEEDEDand the estimate, and nothing is charged.- Not English? Pass
language(for example"es") so speech-to-text uses the right language. - Speakers: bring your own AssemblyAI or Deepgram key and pass its options in
providerOptions, such as{ "speaker_labels": true }for AssemblyAI. See provider options. - Need the audio too? Call
POST /importwith"includeVideo": falseand"includeTranscript": trueto get the audio file and its transcript from one job, or add"store": trueto copy the file into your own S3, R2 or B2 bucket. - Check before you pay:
POST /metadata/basicreturns the episode title, duration and artwork for $0.003.
What it costs
AI speech-to-text is $0.01 per minute of audio, with fetching the audio included. A 30-minute episode is $0.30 and a one-hour episode is $0.60. With your own speech-to-text key it's $0.005 a minute, plus your provider's fees. Failed transcriptions are refunded automatically. New accounts get $3 of free credit with no card, enough for about five hours of episodes. 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 podcast 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
Can I transcribe a podcast from an Apple Podcasts link?
Yes. Send the episode page URL (the one with ?i= in it). Importly finds the episode's audio and transcribes it. A show page without an episode id isn't a single episode, so pick the episode first.
Can I send the MP3 from the RSS feed instead?
Yes. Direct links to audio files work, including feed enclosure URLs that go through tracking redirects. If your app already reads the feed, sending the enclosure URL is the simplest route.
How long does an hour-long episode take?
Longer than a request should stay open, so use webhookUrl and let Importly call you when it's done. "wait": true is for short media.
Do I get timestamps?
Yes. Every transcript has segments with start and end times in seconds, which is what you need for show notes with chapter links, clips and search that jumps to the right moment.
What about Spotify?
Send the episode's Apple Podcasts page or its RSS audio link. Most shows publish the same episode in both places.
Related: YouTube transcript API, SoundCloud download API, Audio extraction API, Transcripts.