Met de podcast-API doe je vanuit je eigen software wat je ook in Mijn studio doet: een aflevering uploaden, de tekst aanpassen, publiceren en cijfers ophalen. De API hoort bij Pro en Podcast Pro.

Een sleutel maken

Ga in Mijn studio naar Podcast en dan naar Netwerk en API. Geef de sleutel een naam (bijvoorbeeld de naam van je software) en kies Nieuwe sleutel. Je ziet de sleutel één keer: kopieer hem meteen. Kwijt? Trek hem in en maak een nieuwe.

Stuur de sleutel bij ieder verzoek mee:

`` Authorization: Bearer sfm_… ``

Het adres van de API is https://sendfm.com/api/podcast/v1. Je mag 120 verzoeken per minuut doen.

Wat de API kan

VerzoekWat
GET /showsJe podcasts, met het adres van de pagina en de feed
GET /shows/{id}/episodesDe afleveringen van een podcast, nieuwste eerst
GET /shows/{id}/statsDownloads per dag, per aflevering, per app en per land
POST /shows/{id}/episodesNieuwe aflevering uploaden (zie hieronder)
GET /episodes/{id}De stand van een aflevering (verwerken, klaar, fout)
PATCH /episodes/{id}Titel, shownotes, seizoen, nummer of publiceren wijzigen

Een aflevering uploaden

Stuur een multipart/form-data-verzoek met het bestand in file. De andere velden mogen:

  • title: de titel;
  • description: de shownotes;
  • rights=1: verplicht. Je bevestigt daarmee dat je de rechten hebt op alles wat in de aflevering te horen is, ook op muziek;
  • publish=nu: meteen publiceren zodra het bestand verwerkt is (zonder dit veld blijft het een concept);
  • loudness=0: luidheid niet gelijktrekken (standaard doen we dat wel);
  • intro=1: je vaste intro en outro meebakken.

`` curl -H "Authorization: Bearer sfm_…" \ -F "file=@aflevering-12.mp3" -F "title=Aflevering 12" -F "rights=1" -F "publish=nu" \ https://sendfm.com/api/podcast/v1/shows/3/episodes ``

Het antwoord heeft het nummer van de aflevering. Verwerken gebeurt op de achtergrond; vraag met GET /episodes/{id} of de status al klaar is.

Wijzigen en inplannen

Met PATCH /episodes/{id} en JSON wijzig je een aflevering. Inplannen gaat met "publish": "gepland" en "publishAt": "2026-11-01T09:00" (Nederlandse tijd).

Foutmeldingen

Een fout heeft altijd een veld error: sleutel (sleutel klopt niet of de API hoort niet meer bij je pakket), niet-gevonden, ongeldig (met de velden die niet klopten), kan-niet (met een uitleg, bijvoorbeeld als je ruimte vol is) of te-veel (te veel verzoeken in een minuut).

Netwerkpagina

Onder Netwerk en API maak je ook een netwerkpagina: één adres (/netwerk/jouw-naam) met al je openbare podcasts. Handig voor een bureau of een omroep met meerdere programma's.