Direct audio APINot available yet
Podcast transcription API full episodes with word timing
Public audio links and podcast MP3 files, up to 2 hours per episode, through AI transcription.
Not available yet. Direct media links are not enabled on this deployment yet. YouTube and TikTok captions are available today.
1.0Capabilities
Core advantages and the limits that come with them
Transcribe podcast episodes from direct audio links, including RSS enclosure URLs, with timed segments and word timing.
Operational limits and transparency
- Maximum audio file size is 250 MB (262,144,000 bytes).
- Maximum episode duration is 7,200 seconds (2 hours).
- Single region infrastructure; AI transcription is billed at 2 credits per started minute with a 60 second minimum.
2.0Implementation
Request and response the exact request and what comes back
POST/v1/jobs
curl -X POST https://api.transcriptdock.com/v1/jobs \-H "Authorization: Bearer td_live_..." \-H "Content-Type: application/json" \-H "Idempotency-Key: $(uuidgen)" \-d '{"source": {"url": "https://media.example.com/podcasts/episode-104.mp3"},"mode": "transcribe"}'
Job outcome
{"id": "8e9f0a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b","status": "succeeded","stage": null,"result_id": "1f2a3b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c","error": null,"billing": {"credits_reserved": 0,"credits_charged": 80,"kind": "ai_transcription"},"source": {"platform": "direct","media_id": null,"canonical_url": "https://media.example.com/podcasts/episode-104.mp3","title": null,"upload_id": null},"options": {"mode": "transcribe","language": null,"caption_preference": "prefer_creator"},"created_at": "2026-09-12T17:20:00Z"}
3.0Questions
Frequently asked
What happens with captions, AI transcription and limits for this source.
Can I submit RSS enclosure URLs?
Yes. Direct HTTPS links to MP3, M4A, or WAV audio files hosted on podcast content delivery networks are accepted.
How do webhooks work for long podcast episodes?
You can pass webhook_endpoint_id in the job request to receive an automated notification as soon as transcription finishes.