Audio transcription: how to turn audio and video into text (API, Python, no code)
Speech to text with Whisper: transcribe audio and video files and podcast episodes, with timestamps and SRT or VTT subtitles. This guide shows the output fields, a working input, and
Python, JavaScript and cURL code for the Actor v0iddo/audio-transcription on Apify.
Open Audio transcription on Apify
What data you get
One row per result. Every row can be downloaded as JSON, CSV, Excel or HTML, or read through the API.
| Field | Label | Type | Example |
|---|---|---|---|
fileName | File | text | Jfk_rice_university_we_choose_to_go_to_the_moon.ogg |
episodeTitle | Episode | text | |
language | Language | text | en |
durationSeconds | Length (s) | number | 1060.2 |
billedMinutes | Minutes charged | number | 8 |
wordCount | Words | number | 954 |
text | Transcript | text | President Tipton, Mr. Vice President, Governor, Congressman Thomas,... |
mediaUrl | Media | URL | https://upload.wikimedia.org/wikipedia/commons/5/50/Jfk_rice_univer... |
source | text | url | |
contentType | text | application/ogg | |
fileBytes | number | 17193282 | |
transcribedSeconds | number | 480 | |
truncated | true/false | true | |
languageProbability | number | 0.954 | |
task | text | transcribe | |
model | text | base | |
segments | list | [{"start": 2.45, "end": 11.53, "text": "President Tipton, Mr. Vice ... | |
processingSeconds | number | 41.5 | |
transcribedAt | text | 2026-10-26T07:27:02Z |
Input example
This is the input that is pre-filled on the Actor page. Change the values for your own run.
{
"mediaUrls": [
"https://upload.wikimedia.org/wikipedia/commons/5/50/Jfk_rice_university_we_choose_to_go_to_the_moon.ogg"
],
"maxMinutesPerFile": 8,
"maxItems": 1
}
| Input field | Type | What it does |
|---|---|---|
mediaUrls | array | Direct links to media files: MP3, M4A, AAC, WAV, OGG, OPUS, FLAC, MP4, MOV, WEBM and more. |
podcastFeeds | array | RSS feed links of podcasts. |
episodesPerFeed | integer | How many of each feed's newest episodes to transcribe. |
episodeKeywords | array | Keep only feed episodes whose title holds one of these words. |
language | string | The language spoken in the files. |
task | string | Write the text in the spoken language, or translate it to English. |
model | string | Speech recognition model. |
maxMinutesPerFile | integer | Only the first this many minutes of each file are transcribed and charged; the row says when a file was cut. |
includeSegments | boolean | Return the transcript also as segments with start and end seconds. |
includeSubtitles | boolean | Return the transcript also as SRT and WebVTT subtitle text. |
maxItems | integer | The run stops after this many result rows. |
Output sample
Real rows from a run of the Actor. Fields that name people are left out of the sample.
[
{
"source": "url",
"mediaUrl": "https://upload.wikimedia.org/wikipedia/commons/5/50/Jfk_rice_university_we_choose_to_go_to_the_moon.ogg",
"fileName": "Jfk_rice_university_we_choose_to_go_to_the_moon.ogg",
"contentType": "application/ogg",
"fileBytes": 17193282,
"durationSeconds": 1060.2,
"transcribedSeconds": 480,
"truncated": true,
"language": "en",
"languageProbability": 0.954,
"task": "transcribe",
"model": "base",
"text": "President Tipton, Mr. Vice President, Governor, Congressman Thomas, Senator Wiley and Congressman Miller, Mr. Webb, Mr. Bell, scientists,...",
"wordCount": 954,
"segments": [
{
"start": 2.45,
"end": 11.53,
"text": "President Tipton, Mr. Vice President, Governor, Congressman Thomas, Senator Wiley and Congressman"
},
{
"start": 11.53,
"end": 20.61,
"text": "Miller, Mr. Webb, Mr. Bell, scientists, distinguished guests and ladies and gentlemen. I appreciate"
},
{
"start": 20.61,
"end": 27.21,
"text": "your president having made me an honorary visiting professor, and I will assure you that"
}
],
"billedMinutes": 8,
"processingSeconds": 41.5,
"transcribedAt": "2026-10-26T07:27:02Z"
}
]
Code: Python, JavaScript and cURL
Get your API token in Apify Console under Settings, then Integrations. The Actor id is v0iddo/audio-transcription.
Python (apify-client)
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {'mediaUrls': ['https://upload.wikimedia.org/wikipedia/commons/5/50/Jfk_rice_university_we_choose_to_go_to_the_moon.ogg'],
'maxMinutesPerFile': 8,
'maxItems': 1}
run = client.actor("v0iddo/audio-transcription").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
JavaScript (apify-client)
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const input = {
"mediaUrls": [
"https://upload.wikimedia.org/wikipedia/commons/5/50/Jfk_rice_university_we_choose_to_go_to_the_moon.ogg"
],
"maxMinutesPerFile": 8,
"maxItems": 1
};
const run = await client.actor('v0iddo/audio-transcription').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
cURL
curl -X POST "https://api.apify.com/v2/acts/v0iddo~audio-transcription/run-sync-get-dataset-items" \
-H "Authorization: Bearer YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"mediaUrls": ["https://upload.wikimedia.org/wikipedia/commons/5/50/Jfk_rice_university_we_choose_to_go_to_the_moon.ogg"], "maxMinutesPerFile": 8, "maxItems": 1}'
Price
$10.00 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $7.00 per 1,000. See the pricing tab for your plan. A new Apify account gets $5 of platform credit every month.
Good to know
- One row per file: the whole text, its language, the length of the file, the minutes transcribed and, when asked, timestamped segments and SRT / VTT subtitles. Podcast rows add the show, the...
- Speed: about 6 minutes of audio per minute of run time with the base model at the default 4 GB of memory (8 GB is about twice as fast at the same price per minute). Long files fit in one run up to...
- Silence and music are skipped before recognition, so a long intro does not produce made up text; the minutes charged are the minutes of the file that were processed.
- Files are fetched only from addresses whose robots.txt allows it, and not from hosts that close their content to machine learning agents in robots.txt (several large podcast hosts do). Such a file...
FAQ
What data does the Audio transcription return?
Each result is one row in an Apify dataset. Fields include fileName, episodeTitle, language, durationSeconds, billedMinutes, wordCount, text, mediaUrl, and more. The table above shows every field with an example value.
How do I use the Audio transcription from Python?
Install the apify-client package, create a client with your Apify API token, call the Actor v0iddo/audio-transcription with an input like the one above, and read the rows from the run's dataset. The Python snippet above does exactly that.
Can I use it without writing code?
Yes. Open the Actor page on Apify, fill in the input form (an example is already filled in), press Start, and download the results as JSON, CSV, Excel or HTML. You can also schedule runs there.
How much does it cost?
$10.00 per 1,000 results. You pay per result row. There is no separate charge per run. Higher Apify plans pay less per result, down to $7.00 per 1,000. A new Apify account gets $5 of platform credit every month.
How do I limit the number of results?
Set the maxItems input field to the number of results you need; the run stops there, so it also caps the cost of one run. You can also set a maximum cost for a run in the run options on Apify, and the run stops when it is reached.
Can I send the results to Google Sheets, Make, Zapier or n8n?
Yes. Apify datasets connect to Google Sheets, Slack, Make, Zapier and n8n, and a webhook can call your own service when a run finishes. You can also export the dataset as JSON, CSV or Excel.
Open Audio transcription on Apify
Related guides
- Google Maps Scraper: Scrape Google Maps business listings by search and place: name, category, address, coordinates, rating, rev...
- Bulk file and image downloader: Download files in bulk from direct links, or every image, video, audio file, PDF, document or archive on a...
- Video frame extractor: Extract still frames from video files as JPEG, PNG or WebP images with timecodes: one every N seconds, a nu...