With the podcast API you do from your own software what you also do in My studio: upload an episode, change its text, publish it and fetch statistics. The API comes with Pro and Podcast Pro.
Creating a key
In My studio, go to Podcast and then Network and API. Give the key a name (for example the name of your software) and choose New key. You see the key once: copy it right away. Lost it? Revoke it and make a new one.
Send the key with every request:
`` Authorization: Bearer sfm_… ``
The API lives at https://sendfm.com/api/podcast/v1. You can make 120 requests per minute.
What the API can do
| Request | What |
|---|---|
GET /shows | Your podcasts, with the address of the page and the feed |
GET /shows/{id}/episodes | The episodes of a podcast, newest first |
GET /shows/{id}/stats | Downloads per day, per episode, per app and per country |
POST /shows/{id}/episodes | Upload a new episode (see below) |
GET /episodes/{id} | The state of an episode (processing, ready, error) |
PATCH /episodes/{id} | Change title, show notes, season, number or publishing |
Uploading an episode
Send a multipart/form-data request with the file in file. Optional fields:
title: the title;description: the show notes;rights=1: required. With it you confirm that you hold the rights to everything that can be heard in the episode, music included;publish=nu: publish as soon as the file is processed (without this field it stays a draft);loudness=0: do not normalise loudness (we do by default);intro=1: add your fixed intro and outro.
`` curl -H "Authorization: Bearer sfm_…" \ -F "file=@episode-12.mp3" -F "title=Episode 12" -F "rights=1" -F "publish=nu" \ https://sendfm.com/api/podcast/v1/shows/3/episodes ``
The answer holds the episode number. Processing happens in the background; ask GET /episodes/{id} whether status is klaar (ready) yet.
Changing and scheduling
With PATCH /episodes/{id} and JSON you change an episode. Schedule with "publish": "gepland" and "publishAt": "2026-11-01T09:00" (Amsterdam time).
Errors
An error always has an error field: sleutel (wrong key, or the API is no longer part of your plan), niet-gevonden (not found), ongeldig (invalid, with the fields that were wrong), kan-niet (not possible, with an explanation, for example when your storage is full) or te-veel (too many requests in a minute).
Network page
Under Network and API you can also make a network page: one address (/netwerk/your-name) with all your public podcasts. Useful for an agency or a broadcaster with several shows.