Skip to content
Podsworth API

Podsworth API

Clean up podcast audio from your own software. Create a project, upload or import its files, submit it, and get the processed audio, transcript and manifest back, with webhooks along the way.
QuickstartAPI reference

Projects

One recording, one to eight tracks. We measure every file, charge credits for what we measure, and deliver each output with its own link. Projects →

Uploads and imports

Upload straight to storage with a presigned form, or have us import from any https URL, Dropbox or Google Drive. Uploads and imports →

Test mode

Test keys run your whole integration, webhooks included, through a simulator. Nothing is processed and nothing is charged. Test mode →

Webhooks

Signed events for every status change and every credit grant, retried for three days, plus an events feed to catch up. Webhooks →

The basics

Section titled “The basics”
  • Base URL: https://api.podsworth.com. Live and test keys use the same host.
  • Authentication: Authorization: Bearer pw_test_… (or pw_live_…). Owners and admins create keys on their account page. See Authentication.
  • Format: JSON in and out, camelCase fields, timestamps in UTC (ISO 8601). Errors look like {"error": {"code": "…", "message": "…"}}. See Errors and limits.
  • Credits: one credit is one minute of audio, charged by the second for what we measure. Live projects spend the account’s credits when submitted; failed or cancelled projects get them back. See Credits.
  • For agents: llms.txt, all guides in one file and the OpenAPI file.