Listen APIFAQs

1. Warum sollte ich Listen API anstelle der iTunes API verwenden? 🔗

Du kannst jederzeit eine eigene Podcast-Datenbank erstellen und pflegen oder eine andere API wählen.

Wir bieten transparente Preise und eine vollständige Dokumentation mit JSON-Beispielen.

Du kannst ohne Kreditkarte und Verkaufsgespräch mit FREE beginnen.

Bei PRO oder ENTERPRISE erhältst du unter hello@listennotes.com schnell eine Antwort direkt vom Gründer und CEO.

Der iTunes API können wichtige Endpoints und strukturierte Daten fehlen; ihre Suche liefert nur wenige, teils schlecht sortierte Ergebnisse, ihre Bedingungen sind restriktiver und die persönliche Unterstützung ist begrenzt.

Mehr dazu: So bewertest du eine RESTful API eines Drittanbieters.

2. Wie schwierig kann es sein, eine Podcast-Datenbank aufzubauen? 🔗

Der Aufbau einer guten Podcast-Datenbank ist keine einmalige Aufgabe. Er ist nicht besonders schwierig, kostet aber fortlaufend Zeit und Geld für Server, Entwickler und Wartung. Wie bei einem Auto oder Haus sind die laufenden Kosten meist höher als die Anschaffung.

Im Internet gibt es mindestens 3,831,088 Podcasts und 196,732,836 Episoden, und die Menge wächst ständig. Bei insgesamt 3,831,088 Podcasts und 196,732,836 Episoden ändern sich RSS-Feeds und Audio-URLs häufiger als erwartet; die Daten müssen daher rund um die Uhr automatisch und manuell bereinigt werden. Eine Stichwortsuche in 3,831,088 Podcasts und 196,732,836 Episoden erfordert eine komplexe Suchinfrastruktur. Außerdem müssen gefälschte oder maschinell erzeugte Podcasts erkannt und entfernt und alle Server zuverlässig betrieben werden.

Der größte Aufwand einer eigenen Datenbank sind letztlich die Opportunitätskosten: Zeit für die Datenbank fehlt bei der Entwicklung deiner eigentlichen App oder Website.

Mit Listen API kannst du sofort am interessanten Teil deines Projekts arbeiten. Mehr als 2,000,000 Menschen nutzen monatlich listennotes.com und helfen uns, fehlende Podcasts einzureichen sowie fehlerhafte Daten zu korrigieren. Mit dieser weltweiten Unterstützung pflegen wir rund um die Uhr eine hochwertige Podcast-Datenbank.

3. Unterstützt ihr die API aktiv und wird das auch künftig so bleiben? 🔗

Ja und ja.

Listen API bildet die Grundlage unserer öffentlich zugänglichen Website ListenNotes.com und profitiert von den meisten Backend-Verbesserungen der Website.

Uns gibt es seit 2017 und wir planen, noch lange zu bleiben.

4. Was passiert, wenn wir Listen API nutzen und sie künftig eingestellt wird? 🔗

Deine Sorge ist berechtigt: Kein Onlinedienst und kein Unternehmen besteht ewig. Google stellt beispielsweise regelmäßig eigene Produkte ein.

Sollten wir Listen API einstellen, kündigen wir dies mindestens zwölf Wochen vorher an. Du kannst dann einen aktuellen Datenbank-Dump mit allen Podcasts und Episoden zu einem angemessenen Preis erwerben.

Listen Notes wird vermutlich viele gut finanzierte Startups und sogar börsennotierte Unternehmen überdauern. Wir führen das Unternehmen schlank, beschäftigen kein riesiges Team und halten unsere Infrastruktur robust, ohne unnötig Geld für Server auszugeben. Dadurch ist eine Schließung infolge interner Machtkämpfe oder überhöhter Personalkosten unwahrscheinlich.

5. Bietet ihr Support an? 🔗

Ja. Wenn du PRO oder ENTERPRISE abonniert hast, schreib bei API-Fragen einfach an hello@listennotes.com. Gelegentlich beantworten wir auch Fragen von FREE-Nutzern, müssen PRO- und ENTERPRISE-Nutzer jedoch bevorzugt betreuen.

Statt dich wie bei anderen Unternehmen mit wenig hilfreichen Kundendienstmitarbeitern herumzuschlagen, sprichst du direkt mit dem Gründer und CEO von Listen Notes, Inc., der das gesamte Produkt mit viel Herzblut selbst aufgebaut hat.

6. Wir werden sehr viele API-Requests senden. Könnt ihr diese Größenordnung bewältigen? 🔗

Derzeit senden Unternehmen über Listen API mehrere zehn Millionen Requests pro Monat. Ohne zusätzliche Server können wir problemlos mindestens das Zehnfache des aktuellen Datenverkehrs bewältigen.

Wir wenden bewährte Verfahren für den Infrastrukturbetrieb an und verfügen über umfassende Überwachungs- und Warnsysteme. Bei Infrastrukturproblemen können wir die Ursache schnell finden und beheben. Unser bisheriger Verlauf bei Leistung und Verfügbarkeit ist sehr gut.

7. Dürfen wir die API-Antwort clientseitig zwischenspeichern, etwa in der App oder im Browser? 🔗

Ja. Unsere API-Nutzungsbedingungen für FREE und PRO erlauben es, Antwortdaten clientseitig, etwa in der App oder im Browser, zwischenzuspeichern. Serverseitiges Caching ist bei FREE und PRO dagegen nicht erlaubt, ausgenommen podcast/episode ids und pub_dates.

Auf dem Server, beispielsweise in deiner eigenen Datenbank, darfst du dauerhaft also nur podcast/episode ids und pub_dates speichern. Diese Regel ist bei Daten-APIs üblich. Die eigentlichen Podcast-Audiodateien darfst du auf deinem Server speichern und verarbeiten, etwa für Audioclips oder Speech-to-Text.

Bei ENTERPRISE darfst du die vollständigen Antwortdaten auf deinen Servern zwischenspeichern.

8. Warum stammen die Audio-URLs in der API-Antwort von der Domain listennotes.com? 🔗

Wir speichern Audiodateien nicht auf eigenen Servern. Podcaster erhalten daher weiterhin korrekte Analysedaten wie IP-Adresse und User-Agent der Hörer.

Da Podcasts ihre Audio-URLs häufig ändern, legen wir unsere dauerhafte URL per HTTP 301 um die tatsächliche URL. So können wir dir und deinen Nutzern weiterhin die richtige Datei liefern.

Apps können die dauerhafte Listen Notes-URL zur Leistungsoptimierung clientseitig zwischenspeichern, während wir serverseitig die jeweils richtige Audio-URL ermitteln und Änderungen fortlaufend prüfen.

9. Was können wir tun, wenn wir einen bestimmten Podcast nicht finden oder die Daten nicht mit dem RSS-Feed übereinstimmen, etwa wegen defekter Audiodateien oder falscher Metadaten? 🔗

Obwohl unsere Podcast-Datenbank sehr umfassend ist, entdecken wir neue Sendungen möglicherweise nicht sofort. Das ist ähnlich wie bei neuen Websites, die Google erst crawlen und indexieren muss. Du kannst in diesem Fall die fehlende Sendung einreichen.

Es kann auch sein, dass ein Produzent den RSS-Feed geändert hat, wir die Änderung noch nicht erkannt haben oder der Feed Fehler enthält. Melde Metadatenfehler an hello@listennotes.com; normalerweise beheben wir sie innerhalb weniger Minuten. Alternativ kannst du unsere Selbstbedienungswerkzeuge zur Korrektur von Metadaten verwenden.

10. Wie haltet ihr eure Podcast-Datenbank aktuell? 🔗

Wir finden neue Podcasts auf vier Wegen:

Crawler suchen rund um die Uhr nach öffentlich zugänglichen Podcasts.
Podcaster reichen neue Sendungen ein.
Mitarbeiter ergänzen fehlende Podcasts. Außerdem können die mehr als 2,000,000 monatlichen Nutzer von listennotes.com fehlende Sendungen einreichen. Jede Einreichung wird manuell geprüft.
Große Hostingdienste sind in unsere Podcast API integriert.

Wir prüfen alle RSS-Feeds fortlaufend. Neue Episoden kürzlich genutzter Podcasts erscheinen innerhalb einer Stunde, meist nach 15 bis 30 Minuten; bei anderen Podcasts dauert es zwei bis vier Stunden.

11. Was passiert, wenn wir gegen die API-Nutzungsbedingungen verstoßen? 🔗

Bei einem Verstoß gegen unsere API-Nutzungsbedingungen wird dein Konto gesperrt. Einen Einspruch kannst du an hello@listennotes.com senden.

Die zwei häufigsten Gründe sind mehrere Konten zur Umgehung des FREE-Kontingents, insbesondere mit Wegwerf-E-Mail-Adressen, sowie das serverseitige Zwischenspeichern des Großteils der Antwortdaten. Achte darauf, nicht gegen die API-Nutzungsbedingungen zu verstoßen.

12. Müssen wir das Listen Notes-Logo auch bei einem kostenpflichtigen Tarif in unserer App anzeigen? 🔗

Ja. Unsere API-Nutzungsbedingungen gelten für alle FREE- und PRO-Nutzer. Du musst "Powered by Listen Notes" nur auf einem Bildschirm anzeigen, der unsere Daten nutzt, nicht auf jedem. Das Logo darf unterhalb des sichtbaren Bereichs stehen.

Wir machen für FREE- oder PRO-Nutzer keine Ausnahmen, unabhängig davon, ob es sich um Einzelentwickler oder börsennotierte Unternehmen handelt. Einmalige Sonderlösungen erhöhen unseren Betriebsaufwand und nehmen Zeit von der Verbesserung der Kernprodukte.

Quellenangaben sind bei Daten-APIs üblich. Auch Uber zeigt beispielsweise bei der Nutzung von Google Maps ein deutliches Google-Logo.

Bei ENTERPRISE können wir die Logoanforderung flexibel handhaben.

13. Können wir telefonisch über eine Partnerschaft sprechen? 🔗

Listen API ist auf Selbstbedienung ausgelegt. Wenn du nicht innerhalb weniger Minuten verstehst, was Listen API kann und wie sie funktioniert, haben wir es nicht gut genug erklärt. Schreib bei Fragen zunächst an hello@listennotes.com.

Per E-Mail erhältst du von uns wesentlich schneller eine hilfreiche Antwort, als wenn du einen Telefontermin vereinbarst.

14. Kann ich Listen API auf No-Code-Plattformen verwenden? 🔗

Ja, sofern die gewünschte No-Code-Plattform eine Verbindung zu einer REST API unterstützt. Mit Listen API kannst du beispielsweise Podcasts in Apps von Bubble und Retool suchen.

Wenn du lediglich abspielbare Podcasts, Episoden, Clips oder Playlists in deine Website oder deinen Blog einbetten möchtest, brauchst du Listen API nicht. Solche Inhalte lassen sich einfach in WordPress, Blogger, Ghost, Google Sites, Tumblr und viele weitere Plattformen einbetten.

15. Bietet ihr sprachspezifische Bibliotheken für die Podcast API an? 🔗

Ja. Einige Bibliotheken sind bereits verfügbar. Künftig werden wir Bibliotheken für weitere Sprachen hinzufügen.

16. Welche Daten erhebt Listen Notes von API-Nutzern? 🔗

Wir erfassen nur ein Mindestmaß an Informationen über das Gerät, das API-Requests direkt an unsere Server sendet: die IP-Adresse, den User-Agent sowie Endpoint und Parameter. Das entspricht im Wesentlichen einer Zeile im Nginx-Zugriffsprotokoll. Mehr nicht.

Sendet bei einer Podcast-App der Server des Entwicklers die Requests, fungiert er als Proxy zwischen App und Listen API. Wir erfassen dann nur IP-Adresse und User-Agent dieses Servers sowie Endpoint und Parameter der Requests. Über die Endnutzer der Podcast-App erfahren wir darüber hinaus nichts.

17. Gibt es bei Listen API Rate-Limits, etwa N Requests pro Sekunde? 🔗

Ja. Für unsere API-Endpoints gelten angemessene Rate-Limits. Bei korrekter Nutzung wirst du sie wahrscheinlich gar nicht bemerken.

Jede seriöse REST API benötigt Rate-Limits, um DDoS-Angriffe und versehentliche Request-Schleifen abzufangen. Seit dem Start von Listen API im Jahr 2017 erleben wir solche Fehler häufiger als erwartet. Ein einzelner fehlerhafter Nutzer soll nicht das gesamte System und damit andere API-Nutzer beeinträchtigen.

FREE hat ein niedrigeres, PRO ein höheres und ENTERPRISE das höchste Rate-Limit. Je nach Rechenaufwand gelten für verschiedene Endpoints unterschiedliche Limits. Neue API-Nutzer beginnen mit vergleichsweise niedrigen Limits, die im Laufe der Zeit angehoben werden.

18. Bearbeitet ihr Löschanfragen für Podcasts gemäß DMCA, DSGVO und ähnlichen Gesetzen? 🔗

Ja. Wir bearbeiten Anfragen zur Entfernung von Inhalten. Mehr dazu:

Du kannst Entfernungsanfragen deiner Nutzer über den Endpoint DELETE /podcasts/{id} an Listen Notes weiterleiten oder sie einfach an hello@listennotes.com schicken.

19. Darf ich Podcast-Audio mithilfe von Listen API rechtmäßig in meinen Apps oder auf meinen Websites streamen? 🔗

Ja, du darfst Podcast-Audio mit Listen API rechtmäßig in deinen Apps oder auf deinen Websites streamen. Hier erfährst du mehr.

Sollte der App Store deine App wegen der API-Integration ablehnen, helfen wir dir gern.