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

RequestWhat
GET /showsYour podcasts, with the address of the page and the feed
GET /shows/{id}/episodesThe episodes of a podcast, newest first
GET /shows/{id}/statsDownloads per day, per episode, per app and per country
POST /shows/{id}/episodesUpload 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.