Automatiseringen bouwen met de SereneReader API
Waarom je leesgedrag automatiseren?
RSS brengt al content van veel bronnen op één plek samen. Met de SereneReader API kun je die content ophalen in scripts, cron-jobs en andere tools.
Authenticatie werkt met één API-sleutel: maak er een aan, stuur hem mee bij elke HTTP-aanvraag en ontvang JSON terug. De API is alleen-lezen en heeft geen webhooks, dus scripts bevragen hem periodiek volgens een schema.
Aan de slag
API-toegang is inbegrepen bij Pro ($5/maand via het web) en Team.
Een API-sleutel aanmaken
Open in SereneReader de Instellingen en kies het tabblad API. Maak een sleutel aan, geef hem een naam die je later herkent, en sla hem ergens veilig op; hij wordt maar één keer getoond. Pro-accounts kunnen maximaal 5 sleutels hebben en Team-accounts maximaal 10.
Authenticatie
Elke aanvraag vereist je sleutel als Bearer-token in de Authorization-header. Er zijn geen client-ID's, refresh-tokens of scopes. Het API-tabblad in Instellingen toont de basis-URL, de endpoints en voorbeeldaanvragen.
Limieten
De API staat 30 aanvragen per minuut per account toe, gedeeld over al je sleutels — ruim voldoende voor scripts die op een schema draaien. Elke response bevat een X-RateLimit-Remaining-header. Als je de limiet overschrijdt, geeft de API 429 terug met een Retry-After-header; wacht het aangegeven aantal seconden voordat je het opnieuw probeert.
Wat je kunt doen
De API geeft je leestoegang tot je artikelen en abonnementen:
GET /api/v1/articlesgeeft artikelen uit je feeds terug, nieuwste eerst. Je kunt filteren op feed, map of publicatiedatum, en door resultaten bladeren (standaard 50 per aanvraag, maximaal 200). Elk artikel bevat de titel, URL, feednaam, auteur, publicatiedatum, een samenvatting en of je het hebt gelezen of gemarkeerd.GET /api/v1/feedstoont je abonnementen met het aantal ongelezen items en de mapindeling.GET /api/v1/usagelaat zien hoeveel aanvragen de gebruikte sleutel heeft gedaan in de afgelopen uur, 8 uur en 24 uur.
Het API-tabblad in Instellingen bevat de volledige lijst met parameters en responsvelden.
Toepassingen
Dagelijkse samenvatting per e-mail
Schrijf een script dat elke ochtend om 7 uur draait, de artikelen van de vorige dag ophaalt en je een samenvattings-e-mail stuurt. Filter op datum, stuur de JSON door jq om titels en URL's eruit te halen, en verzend het resultaat met de e-mail- of notificatietool die je gebruikt.
Stille-feed-controle
Feeds raken kapot: domeinen verlopen, paden veranderen, servers vallen uit. De API rapporteert geen ophaalfouten of wanneer een feed voor het laatst iets heeft gepubliceerd, maar een wekelijks script kan toch feeds opsporen die stil zijn geworden. Haal je feeds op, vraag recente artikelen op voor elke feed met de parameters feedId en since, en markeer feeds waarvan de afgelopen weken niets is gepubliceerd. Als je veel feeds hebt, doseer de aanvragen om binnen de limiet te blijven.
Een stille feed is niet altijd een kapotte feed, maar de lijst vertelt je welke blogs je moet controleren.
Exporteren naar andere tools
Haal artikelen op in een lokale database, een Notion-pagina, een Obsidian-kluis of een spreadsheet. De API geeft gestructureerde JSON terug, dus de transformatie is meestal een paar regels jq of een kort Python-script.
Combineren met AI-agents
De API werkt samen met AI-tools die HTTP-aanvragen kunnen doen. Als je een assistent zoals OpenClaw gebruikt, kun je die naar SereneReader laten verwijzen en je feeds laten verwerken. We schreven hier een apart bericht over: Hoe je RSS-feeds verbindt met AI-agents.
Meer ideeën
Nog een paar dingen die je in een paar regels kunt bouwen: een cron-job die je de artikelen van de dag uit één map e-mailt, een shell-alias die de ongelezen aantallen optelt vanuit /api/v1/feeds, of een polling-script dat nieuwe artikelen uit één feed naar een Slack-kanaal plaatst.
Voor geen van deze toepassingen heb je een framework nodig. curl en jq dekken de meeste gevallen af, en elke taal met een HTTP-client werkt voor de rest.
Maak je sleutel aan in Instellingen, op het tabblad API.