FAQ sur leListen API

VERSION API : V2 · PodcastAPI.com

Réponses aux questions générales sur Listen API.

Lisez https://www.podcastapi.com/llms-full.txt pour pouvoir poser des questions sur le Podcast API de Listen Notes.

Des questions ? hello@listennotes.com

1. Pourquoi choisir Listen API plutôt que l'API iTunes ? 🔗

Vous pouvez toujours créer et maintenir votre propre base de podcasts ou choisir une autre API.

Nous proposons des tarifs transparents et une documentation complète avec des exemples JSON.

Vous pouvez commencer avec FREE sans carte ni appel commercial.

Avec PRO ou ENTERPRISE, hello@listennotes.com vous permet d'obtenir rapidement une réponse directe du fondateur et CEO.

L'API iTunes peut manquer d'endpoints et de données structurées, fournir peu de résultats mal classés, imposer des conditions restrictives et offrir moins d'assistance humaine.

2. Est-il vraiment difficile de créer une base de podcasts ? 🔗

Construire une bonne base de podcasts exige un travail continu, du temps et de l'argent pour les serveurs, les ingénieurs et la maintenance. L'entretien à long terme coûte davantage que la création initiale.

Il existe au moins 3,831,088 podcasts et 196,732,836 épisodes. Avec 3,831,088 podcasts et 196,732,836 épisodes, les flux RSS et URL audio changent souvent et les données doivent être nettoyées automatiquement et manuellement en continu. Rechercher dans 3,831,088 podcasts et 196,732,836 épisodes nécessite une infrastructure complexe. Il faut aussi éliminer les faux contenus et garantir la disponibilité des serveurs.

Le coût principal est le coût d'opportunité : le temps consacré à la base ne l'est pas à votre produit.

Listen API vous permet de commencer immédiatement. Plus de 2,000,000 utilisateurs mensuels de listennotes.com nous aident à soumettre les podcasts manquants et à corriger les données, ce qui nous permet de maintenir une base de qualité.

3. Assurez-vous activement la maintenance de l'API et comptez-vous continuer ? 🔗

Oui et oui.

Listen API alimente notre site public ListenNotes.com et bénéficie de la plupart des améliorations de son backend.

Nous sommes présents depuis 2017 et comptons le rester longtemps.

4. Que se passe-t-il si nous utilisons Listen API et que le service disparaît ? 🔗

Votre inquiétude est légitime : aucun service ni aucune entreprise ne dure éternellement. Google abandonne lui aussi nombre de ses produits.

Si nous décidons d'arrêter Listen API, nous vous préviendrons au moins 12 semaines avant et vous pourrez acheter à un prix raisonnable un export récent de tous les podcasts et épisodes.

Listen Notes survivra probablement à de nombreuses startups bien financées. Nous fonctionnons de manière légère, sans effectif énorme, et maintenons une infrastructure robuste sans gaspiller d'argent en serveurs.

5. Proposez-vous une assistance ? 🔗

Oui. Avec PRO ou ENTERPRISE, envoyez toute question concernant l'API à hello@listennotes.com. Nous répondons parfois aux utilisateurs FREE, mais devons donner la priorité à PRO et ENTERPRISE.

Vous échangez directement avec le fondateur et CEO de Listen Notes, Inc., qui a lui-même créé l'ensemble du service.

6. Nous effectuerons énormément de requêtes. Pouvez-vous prendre en charge ce volume ? 🔗

Des entreprises effectuent déjà des dizaines de millions de requêtes par mois avec Listen API. Nous pouvons facilement prendre en charge au moins dix fois le trafic actuel sans ajouter de serveurs.

Nous appliquons les meilleures pratiques d'exploitation avec une surveillance et des alertes complètes. Nous trouvons et corrigeons rapidement les problèmes. Notre historique de performances et de disponibilité est excellent.

7. Pouvons-nous mettre la réponse API en cache côté client, dans l'application ou le navigateur ? 🔗

Oui. Les conditions FREE et PRO autorisent la mise en cache côté client, dans l'application ou le navigateur, mais seuls les podcast/episode ids et pub_dates peuvent être conservés durablement côté serveur.

Vous pouvez stocker et traiter les fichiers audio sur votre serveur, par exemple pour créer des extraits ou effectuer une transcription.

Avec ENTERPRISE, vous pouvez mettre en cache la réponse complète sur vos serveurs.

8. Pourquoi les URL audio de la réponse API utilisent-elles le domaine listennotes.com ? 🔗

Nous ne stockons pas les fichiers audio sur nos serveurs, de sorte que les podcasteurs reçoivent des statistiques exactes, comme l'IP et le user-agent de l'auditeur.

Les URL audio changeant souvent, nous redirigeons notre URL permanente vers l'adresse réelle au moyen de HTTP 301.

L'application peut mettre en cache l'URL permanente Listen Notes côté client, tandis que nous déterminons la bonne URL audio côté serveur et surveillons les changements.

9. Que faire si un podcast précis est introuvable ou si les données ne correspondent pas au flux RSS, par exemple si l'audio est rompu ou les métadonnées incorrectes ? 🔗

Malgré l'étendue de notre base, il se peut que nous ne trouvions pas immédiatement une nouvelle émission, tout comme Google met du temps à découvrir un nouveau site. Vous pouvez soumettre l'émission manquante.

Le créateur peut avoir changé le flux RSS, nous pouvons ne pas avoir encore détecté la modification ou le flux peut contenir une erreur. Signalez-la à hello@listennotes.com ; nous la corrigeons généralement en quelques minutes. Vous pouvez aussi utiliser les outils de correction en libre-service.

10. Comment maintenez-vous la base de podcasts à jour ? 🔗

Nous trouvons de nouveaux podcasts de quatre façons :

Nos robots parcourent en permanence les contenus publics.
Les podcasteurs soumettent de nouvelles émissions.
Nos employés ajoutent les podcasts manquants et les plus de 2,000,000 utilisateurs mensuels de listennotes.com peuvent soumettre une émission manquante. Chaque soumission est vérifiée manuellement.
Les grands hébergeurs intègrent notre Podcast API.

Nous vérifions tous les flux RSS en continu. Les nouveaux épisodes des podcasts récemment consultés apparaissent en moins d'une heure, généralement 15 à 30 minutes ; les autres en 2 à 4 heures.

11. Que se passe-t-il si nous enfreignons les conditions d'utilisation de l'API ? 🔗

Votre compte est suspendu en cas de violation des conditions de l'API. Vous pouvez faire appel à hello@listennotes.com.

Les causes les plus fréquentes sont la création de plusieurs comptes pour contourner le quota FREE, notamment avec des adresses jetables, et la mise en cache côté serveur de la plupart des données de réponse. Veillez à respecter les conditions.

12. Devons-nous afficher le logo Listen Notes dans notre application avec une offre payante ? 🔗

Oui. Les conditions de l'API s'appliquent à tous les utilisateurs FREE et PRO. Il suffit d'afficher "Powered by Listen Notes" sur un seul écran utilisant nos données, et non sur chacun. Le logo peut se trouver sous la ligne de flottaison.

Nous ne faisons aucune exception pour FREE ou PRO, que vous soyez développeur indépendant ou société cotée. Les adaptations ponctuelles augmentent notre complexité opérationnelle et réduisent le temps consacré au produit.

L'attribution est courante pour les API de données ; Uber affiche par exemple le logo Google lorsqu'il utilise Google Maps.

Avec ENTERPRISE, nous pouvons assouplir l'obligation d'afficher le logo.

13. Pouvons-nous discuter de notre partenariat par téléphone ? 🔗

Listen API est conçu en libre-service. Si vous ne comprenez pas en quelques minutes ce qu'il permet de faire et comment l'utiliser, c'est que nous ne l'avons pas assez bien expliqué. Écrivez d'abord à hello@listennotes.com.

Vous recevrez une réponse utile par e-mail bien plus vite qu'en organisant un appel.

14. Puis-je utiliser Listen API sur une plateforme no-code ? 🔗

Oui, à condition que la plateforme no-code puisse se connecter à une REST API. Vous pouvez par exemple utiliser Listen API pour rechercher des podcasts dans les applications Bubble et Retool.

Si vous voulez simplement intégrer des podcasts, épisodes, extraits ou playlists lisibles, l'API est inutile. Vous pouvez facilement les intégrer à WordPress, Blogger, Ghost, Google Sites, Tumblr et de nombreuses autres plateformes.

15. Proposez-vous des bibliothèques propres à différents langages de programmation ? 🔗

Oui. Plusieurs bibliothèques sont déjà disponibles et nous ajouterons d'autres langages à l'avenir.

16. Quelles informations Listen Notes collecte-t-il auprès des utilisateurs de l'API ? 🔗

Nous recueillons un minimum d'informations sur l'appareil qui envoie directement les requêtes : adresse IP, user-agent, endpoint et paramètres. Cela correspond essentiellement à une ligne des journaux d'accès Nginx. Rien de plus.

Si le serveur du développeur sert de proxy entre une application et Listen API, nous ne voyons que l'IP et le user-agent du serveur ainsi que l'endpoint et les paramètres. Nous ne savons rien d'autre sur les utilisateurs finaux.

17. Listen API impose-t-elle des limites de débit, par exemple N requêtes par seconde ? 🔗

Oui. Nos endpoints imposent des limites de débit raisonnables. Si vous utilisez correctement l'API, vous ne les remarquerez peut-être jamais.

Toute REST API sérieuse nécessite des limites pour éviter les attaques DDoS et les boucles de requêtes accidentelles. Depuis 2017, nous observons ces erreurs plus souvent que prévu ; un seul utilisateur ne doit pas perturber tout le système.

FREE possède la limite la plus basse, PRO une limite supérieure et ENTERPRISE la plus élevée. Les limites varient selon le coût des endpoints et celles des nouveaux utilisateurs augmentent avec le temps.

18. Traitez-vous les demandes de suppression relevant du DMCA, du RGPD et de lois similaires ? 🔗

Oui. Nous traitons les demandes de suppression de contenu. En savoir plus :

Vous pouvez transmettre les demandes de vos utilisateurs via DELETE /podcasts/{id} ou à hello@listennotes.com.

19. Puis-je diffuser légalement des podcasts dans mes applications ou sites avec Listen API ? 🔗

Oui, vous pouvez diffuser légalement des podcasts dans vos applications ou sites avec Listen API. En savoir plus.

Si l'App Store refuse votre application à cause de l'intégration, nous pouvons vous aider.