Veelgestelde vragen overListen API

1. Waarom zou ik Listen API gebruiken in plaats van iTunes API? 🔗

Er zijn altijd andere opties: bouw en onderhoud je eigen podcastdatabase of kies een andere Podcast API op internet.

Om Listen API te beoordelen bieden we een transparant en eenvoudig prijsmodel en uitgebreide documentatie voor alle endpoints en voorbeeldresponses in JSON.

Listen API is eenvoudig te proberen: je hoeft niet met verkopers te praten of een demo aan te vragen. Sluit FREE af zonder kaartgegevens en begin direct.

PRO- en ENTERPRISE-klanten kunnen vragen naar hello@listennotes.com sturen en spreken rechtstreeks met de oprichter en CEO van Listen Notes.

Hoe zit het met iTunes API van Apple? Lees de documentatie en probeer het zelf. Het is mogelijk minder geschikt omdat

endpoints en gestructureerde data voor sommige basisfuncties ontbreken;
het weinig zoekresultaten geeft en de rangschikking niet ideaal is;
de voorwaarden je gewenste gebruik mogelijk verbieden;
het wellicht niet actief wordt onderhouden omdat het geen kernproduct van Apple is;
menselijke ondersteuning belangrijk is bij enterprise-API's, terwijl snelle antwoorden van Apple lastig kunnen zijn.

Dit artikel kan helpen: How to evaluate a 3rd party RESTful API?

2. Hoe moeilijk is het om een podcastdatabase te bouwen? 🔗

Een goede podcastdatabase bouwen is een doorlopend proces. Het is niet moeilijk, maar het kost tijd en geld — onder meer voor servers en salarissen van technici — om de database op te bouwen en te onderhouden. Net als bij een auto of huis zijn de aanschafkosten veel lager dan alle terugkerende onderhoudskosten, zoals belastingen, verzekeringen, onverwachte reparaties en vooral uw eigen tijd.

Houd rekening met het volgende voordat u een eigen podcastdatabase bouwt en onderhoudt:

Op internet staan minstens 3,831,088 podcasts en 196,732,836 afleveringen. Het aanbod groeit steeds sneller. U moet de gegevens zelf hosten en actueel houden.
Podcasts wijzigen vaker dan u denkt van RSS-feed en audio-URL, zeker bij 3,831,088 podcasts en 196,732,836 afleveringen. U hebt automatische hulpmiddelen en handmatige processen nodig om de gegevens dag en nacht op te schonen. Dat werk is noodzakelijk, maar onzichtbaar voor gebruikers.
Wilt u 3,831,088 podcasts en 196,732,836 afleveringen op trefwoord doorzoeken, dan moet u ook een eigen zoekmachine bouwen. De interface lijkt eenvoudig, maar de achterliggende infrastructuur is bijzonder complex. Google, ogenschijnlijk ‘een eenvoudige website’, had in 2022 niet voor niets 175.000 vaste medewerkers en daarnaast honderdduizenden opdrachtnemers.
Er staan veel neppodcasts op internet, bijvoorbeeld automatisch gegenereerde audio. Black-hat-SEO-partijen maken er grote aantallen van voor linkbuilding; ze zijn niet bedoeld voor menselijke luisteraars. U hebt automatische én handmatige controles nodig om zulke podcasts uit uw database te weren. Leuk weetje: Google heeft een speciaal webspamteam, en ook Listen Notes besteedt veel middelen aan het bestrijden van neppodcasts.
Moeten de database en zoekmachine 24/7 beschikbaar zijn, dan moet u voortdurend werken aan het voorkomen en oplossen van serverstoringen.
Wat kost een bekwame fulltime software-engineer? Betaalt u liever voor een externe clouddienst zoals onze API, of de salarissen van meerdere eigen software-engineers?

Eerlijk gezegd is de opportuniteitskost het duurste onderdeel van een eigen podcastdatabase. Het draait om keuzes: tijd die u aan de database besteedt, kunt u niet gebruiken om uw apps of websites te bouwen.

Met Listen API kunt u meteen beginnen aan het interessantste deel van uw project. Daarnaast beheren we op listennotes.com een populaire zoekmachine voor podcasts. Elke maand gebruiken meer dan 2,000,000 mensen onze website. Zij helpen onze podcastdatabase actueel te houden, bijvoorbeeld door ontbrekende podcasts in te dienen en onjuiste gegevens te corrigeren. Dankzij deze wereldwijde hulp, dag en nacht, kunnen we een hoogwaardige podcastdatabase onderhouden.

3. Ondersteunen jullie de API actief en blijft dat zo? 🔗

Ja en ja.

Listen API ondersteunt de openbare website ListenNotes.com en profiteert van de meeste backendverbeteringen van Listen Notes. We zijn sinds 2017 actief en willen dat nog lang blijven.

4. Wat gebeurt er als Listen API in de toekomst stopt? 🔗

Uw bezorgdheid is terecht. We weten allemaal dat geen enkele online dienst of onderneming eeuwig blijft bestaan. Zo heeft Google veel eigen producten stopgezet.

Als we besluiten Listen API stop te zetten, laten we u dat minstens twaalf weken van tevoren weten. U kunt dan tegen een redelijk lage prijs de meest actuele databasedump kopen, met alle podcasts en afleveringen.

Listen Notes zal waarschijnlijk langer bestaan dan veel goed gefinancierde start-ups en zelfs sommige beursgenoteerde bedrijven. We houden onze organisatie bewust klein. Anders dan grotere bedrijven hebben we geen enorm personeelsbestand en dus ook geen enorme loonkosten. Daardoor is het onwaarschijnlijk dat een interne machtsstrijd ons bedrijf ten val brengt. Bovendien kunnen we onze software-infrastructuur robuust opzetten zonder onnodig veel aan servers uit te geven.

5. Bieden jullie ondersteuning? 🔗

Ja. PRO- en ENTERPRISE-gebruikers kunnen API-vragen sturen naar hello@listennotes.com. Voor foutopsporing kunnen we om voorbeeldcode of request/response vragen. Persoonlijke ondersteuning is niet gegarandeerd voor FREE, maar documentatie en FAQ zijn beschikbaar.

6. Kunnen jullie zeer grote aantallen API-requests verwerken? 🔗

Sommige bedrijven voeren al tientallen miljoenen requests per maand uit met Listen API. Zonder extra servers kunnen we minstens tien keer het huidige verkeer verwerken.

Neem bij een zeer grote schaal contact op via hello@listennotes.com, zodat we kunnen helpen met capaciteitsplanning.

7. Mag de API-response aan de clientzijde worden gecachet, bijvoorbeeld in de app of browser? 🔗

Ja. Volgens onze API Terms of Use (FREE- en PRO-abonnementen) mag u antwoordgegevens aan de clientzijde cachen, maar bij FREE en PRO niet aan de serverzijde, met uitzondering van podcast-/afleverings-id's en pub_dates.

U mag dus alleen podcast-/afleverings-id's en pub_dates permanent aan de serverzijde opslaan, bijvoorbeeld in uw eigen database. Dit beleid waarbij server-side caching niet is toegestaan, komt veel voor bij data-API's, zoals de Google Maps API (zoek op de pagina naar ‘No Scraping’).

De audiobestanden van podcasts zelf mag u wel op uw server opslaan en verwerken, bijvoorbeeld om audioclips te maken of spraak naar tekst om te zetten.

Met een abonnement op het ENTERPRISE-abonnement mag u volledige antwoordgegevens op uw servers cachen.

8. Waarom gebruiken audio-URL's in de API-response het domein listennotes.com? 🔗

Voor alle duidelijkheid: we slaan audiobestanden niet op onze eigen servers op. Podcastmakers ontvangen nauwkeurige statistieken, zoals het IP-adres en de user-agent van de luisteraar.

We verpakken de werkelijke URL's in onze eigen URL's via HTTP 301, bijvoorbeeld audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d. Podcasts wijzigen namelijk vaker van audio-URL dan u misschien verwacht, en zo helpen we u en uw gebruikers steeds de juiste URL te vinden.

Voor betere prestaties is het gebruikelijk dat apps gegevens aan de clientzijde cachen. Apps bewaren de permanente Listen Notes-URL's aan de clientzijde, terwijl wij aan de serverzijde de juiste audio-URL bepalen. We controleren voortdurend of podcasts hun audio-URL hebben gewijzigd.

9. Wat als een podcast ontbreekt of de data niet overeenkomt met de RSS-feed, zoals kapotte audio of onjuiste metadata? 🔗

Hoewel onze podcastdatabase zeer uitgebreid is, kan het gebeuren dat we een nieuwe podcast niet op tijd toevoegen. Net zoals nieuwe websites niet meteen in Google te vinden zijn, hebben onze systemen tijd nodig om nieuwe podcasts te ontdekken en te indexeren. U kunt ons dan helpen door de ontbrekende podcast in te dienen.

Het kan ook zijn dat de maker de RSS-feed wijzigt en wij dat niet op tijd opmerken, of dat de RSS-feed fouten bevat. Dit lijkt op verouderde of niet-bestaande pagina's die nog in de zoekresultaten van Google staan: het kost tijd om die te verwijderen. Meld fouten in metadata via hello@listennotes.com; we lossen ze zo snel mogelijk op, doorgaans binnen enkele minuten. U kunt ook onze selfservicetools gebruiken om metadatafouten zelf te corrigeren. Help zo mee de database op orde te houden :)

10. Hoe houden jullie de podcastdatabase actueel? 🔗

We vinden nieuwe podcasts op vier manieren.

Crawlers zoeken continu naar openbaar toegankelijke podcasts.
Podcasters dienen zelf nieuwe programma's in; we ontvangen er dagelijks honderden.
Medewerkers voegen ontbrekende podcasts handmatig toe. Meer dan 2,000,000 mensen gebruiken maandelijks listennotes.com en kunnen ontbrekende programma's indienen. Alle inzendingen worden beoordeeld en neppodcasts afgewezen.
Grote podcasthosts integreren met onze Podcast API, zodat programma's rechtstreeks kunnen worden ingediend.

Alle RSS-feeds worden continu gecontroleerd. Nieuwe afleveringen van onlangs beluisterde podcasts verschijnen binnen een uur, meestal 15–30 minuten. Andere podcasts worden doorgaans binnen 2–4 uur bijgewerkt.

11. Wat gebeurt er als we de API Terms of Use schenden? 🔗

Je account wordt opgeschort als je de API Terms of Use schendt. Maak bezwaar via hello@listennotes.com.

De twee meest voorkomende oorzaken zijn: 1. meerdere accounts aanmaken om het FREE-quotum te omzeilen, vooral met wegwerpadressen; 2. het grootste deel van de response-data op de server cachen. Houd je aan de API Terms of Use.

12. Moeten we ook met een betaald abonnement het Listen Notes-logo in de app tonen? 🔗

Ja. De API Terms of Use gelden voor alle FREE/PRO-gebruikers. Het is voldoende om «Powered by Listen Notes» op één scherm met onze data te tonen, niet op elk scherm.

ENTERPRISE vereist geen logo.

De ingebouwde HTML-speler en Listen API zijn verschillende producten. Het spelerlogo kan ook met een betaald API-abonnement niet worden verwijderd.

13. Kunnen we telefonisch over een samenwerking praten? 🔗

Listen API is ontworpen voor selfservice. Als binnen enkele minuten niet duidelijk is wat de API kan en hoe je hem gebruikt, moeten wij het ontwerp of de documentatie verbeteren.

Als telefonisch overleg over een samenwerking echt nodig is, neem dan eerst contact op via hello@listennotes.com.

14. Kan ik Listen API op no-code-platforms gebruiken? 🔗

Ja, zolang het no-codeplatform van uw keuze verbinding met een REST API kan maken. U kunt Listen API bijvoorbeeld gebruiken om podcasts te zoeken in apps die met Bubble of Retool zijn gebouwd.

Wilt u alleen afspeelbare podcasts, afleveringen, clips of afspeellijsten in uw website of blog opnemen, dan hebt u Listen API niet nodig. U kunt afspeelbare podcasts eenvoudig insluiten in WordPress, Blogger, Ghost, Google Sites, Tumblr en vele andere publicatieplatforms.

15. Bieden jullie taalspecifieke libraries voor Podcast API? 🔗

Ja. We hebben bibliotheken voor enkele programmeertalen. In de toekomst voegen we bibliotheken voor meer talen toe.

16. Welke informatie verzamelt Listen Notes van API-gebruikers? 🔗

We verzamelen zo weinig mogelijk informatie over het apparaat dat API-verzoeken rechtstreeks naar onze servers stuurt: 1) het IP-adres van het apparaat; 2) de user-agent; en 3) het endpoint en de parameters van het API-verzoek. Dit komt in wezen overeen met één regel in de Nginx-toegangslogboeken. Dat is alles.

Stel dat een ontwikkelaar onze API gebruikt om een podcast-app te bouwen en veel eindgebruikers via die app naar podcasts luisteren. API-verzoeken worden doorgaans vanaf de servers van de ontwikkelaar verstuurd, niet vanuit de podcast-app. De servers van de ontwikkelaar fungeren dus als proxy tussen de podcast-app en Listen API. Daarom registreren we alleen 1) de IP-adressen van de servers die API-verzoeken sturen; 2) de user-agent (bijvoorbeeld python-requests) van die servers; en 3) de endpoints en parameters van de API-verzoeken. Verder weten we niets over de eindgebruikers van de podcast-app.

17. Heeft Listen API snelheidslimieten, bijvoorbeeld N requests per seconde? 🔗

Ja. We hanteren redelijke rate limits voor onze API-endpoints. Als u onze API correct gebruikt, merkt u waarschijnlijk niet eens dat ze bestaan.

Elke serieuze REST API moet rate limits hanteren — zoek op Google naar ‘api rate limit’. Zonder rate limits kan een API gemakkelijk via DDoS worden platgelegd. Een programmeur kan bijvoorbeeld in korte tijd vanuit een strakke lus enorm veel API-verzoeken versturen, of nog erger: vanuit een oneindige lus. Sinds we Listen API in 2017 lanceerden, hebben we gemerkt dat dit vaker gebeurt dan verwacht. Programmeurs zijn ook mensen, en mensen maken fouten. We willen niet dat één gebruiker ons hele systeem onderuit haalt en andere API-gebruikers treft.

Bij Listen API heeft het FREE-abonnement een lage rate limit, het PRO-abonnement een hogere en het ENTERPRISE-abonnement de hoogste. De limiet verschilt per endpoint, omdat sommige endpoints meer rekenkracht vereisen dan andere. Nieuwe API-gebruikers beginnen met relatief lage limieten, die in de loop van de tijd worden verhoogd.

18. Behandelen jullie verwijderingsverzoeken op basis van DMCA, AVG en vergelijkbare wetgeving? 🔗

Ja. Wij behandelen verzoeken om inhoud te verwijderen. Meer informatie:

U kunt verwijderingsverzoeken namens uw gebruikers via het volgende API-endpoint doorsturen naar Listen Notes: DELETE /podcasts/{id}. U kunt zulke verzoeken ook gewoon doorsturen naar hello@listennotes.com.

19. Kan ik met Listen API legaal podcastaudio streamen in apps of op websites? 🔗

Jazeker. U mag podcastaudio via Listen API legaal streamen in uw apps of op uw websites. Lees hier meer.

Mocht de App Store uw app afwijzen vanwege de integratie met onze API, dan helpen we u graag.