Domande frequenti suListen API

1. Perché dovrei usare Listen API invece dell'API di iTunes? 🔗

Hai sempre altre possibilità: creare e mantenere un database in proprio oppure scegliere altre Podcast API disponibili su Internet.

Per aiutarti a valutare Listen API offriamo un modello di prezzo semplice e trasparente e una documentazione completa di endpoint e risposte JSON di esempio.

Provarla è facile: non occorre parlare con un commerciale né richiedere una demo. Sottoscrivi il piano FREE senza carta di credito e inizia a usarla.

Con PRO o ENTERPRISE puoi scrivere a hello@listennotes.com e parlare direttamente con il fondatore e CEO di Listen Notes.

E l'API di iTunes? Leggi la documentazione e provala. Potrebbe non essere adatta perché

non offre endpoint e dati strutturati sufficienti per alcune funzioni di base;
restituisce pochi risultati e il ranking non è ideale;
i termini potrebbero non consentire ciò che desideri;
probabilmente non viene mantenuta attivamente perché non è un prodotto centrale per Apple;
un'API enterprise dovrebbe includere assistenza umana, mentre ottenere risposte tempestive da Apple può essere difficile.

Potrebbe esserti utile questo articolo: How to evaluate a 3rd party RESTful API?

2. Quanto può essere difficile creare un database di podcast? 🔗

Creare un buon database di podcast è un lavoro continuo. Non è difficile, ma richiede tempo e denaro per server e sviluppatori. Come per un'auto o una casa, manutenzione e tempo costano più dell'acquisto iniziale.

Considera che:

su Internet esistono almeno 3,831,088 podcast e 196,732,836 episodi, in rapida crescita, da ospitare e aggiornare;
con 3,831,088 podcast e 196,732,836 episodi, feed RSS e URL audio cambiano spesso e richiedono strumenti automatici e interventi manuali continui;
cercare parole chiave in 3,831,088 podcast e 196,732,836 episodi richiede un motore di ricerca. L'interfaccia è semplice, ma il backend è molto complesso: non a caso Google aveva 175.000 dipendenti nel 2022 e centinaia di migliaia di collaboratori;
esistono molti podcast falsi creati automaticamente o per Black Hat SEO. Servono controlli automatici e manuali. Google ha un team dedicato allo spam e anche Listen Notes investe molte risorse;
mantenere database e motore di ricerca operativi 24 ore su 24 richiede lavoro per evitare interruzioni;
conviene confrontare il costo di sviluppatori interni competenti con quello di un servizio cloud come la nostra API.

Il costo maggiore è in realtà il costo opportunità: il tempo impiegato sul database non può essere usato per creare la tua app o il tuo sito.

Listen API ti permette di iniziare subito la parte più interessante del progetto. Ogni mese più di 2,000,000 persone usano listennotes.com e ci aiutano a segnalare podcast mancanti e correggere i dati, mantenendo alta la qualità.

3. Supportate attivamente l'API e continuerete a farlo? 🔗

Sì e sì.

Listen API alimenta il sito pubblico ListenNotes.com e beneficia della maggior parte dei miglioramenti backend di Listen Notes. Siamo operativi dal 2017 e intendiamo esserlo ancora a lungo.

4. Che cosa succede se usiamo Listen API e in futuro il servizio viene chiuso? 🔗

La tua preoccupazione è fondata: nessun servizio o azienda online dura per sempre. Ad esempio, Google ha chiuso molti prodotti.

Se decidessimo di chiudere Listen API, ti avviseremmo con almeno 12 settimane di anticipo e potresti acquistare a un prezzo ragionevole il dump più recente con tutti i podcast e gli episodi.

Listen Notes potrebbe durare più di molte startup finanziate o aziende quotate. Operiamo in modo snello, senza un enorme organico e i relativi stipendi. Abbiamo progettato un'infrastruttura robusta senza sprecare denaro in server.

5. Fornite assistenza? 🔗

Sì. Gli utenti PRO o ENTERPRISE possono inviare domande a hello@listennotes.com. Per il debugging potremmo chiedere codice o esempi di richiesta e risposta. L'assistenza personale non è garantita per FREE, ma sono disponibili documentazione e FAQ.

6. Effettueremo moltissime richieste API. Potete gestire la nostra scala? 🔗

Alcune aziende effettuano già decine di milioni di richieste al mese con Listen API. Senza aggiungere server possiamo gestire almeno dieci volte il traffico attuale.

Per volumi molto elevati scrivi a hello@listennotes.com, così potremo aiutarti a pianificare la capacità.

7. Possiamo memorizzare nella cache lato client la risposta API, ad esempio nell'app o nel browser? 🔗

Sì. Gli API Terms of Use per FREE e PRO consentono la cache lato client, ma non lato server, eccetto gli id di podcast/episodi e i pub_date.

Solo id e pub_date possono essere conservati permanentemente sul server o nel tuo database. Questa regola è comune nelle API di dati, ad esempio Google Maps API (cerca "No Scraping").

Puoi invece conservare e elaborare i file audio reali, ad esempio per creare clip o trascrizioni.

Con il piano ENTERPRISE puoi memorizzare sul server l'intera risposta.

8. Perché nella risposta API gli URL audio appartengono al dominio listennotes.com? 🔗

Non conserviamo l'audio sui nostri server. I podcaster ricevono comunque dati di ascolto accurati, come IP e user-agent.

Poiché gli URL audio cambiano spesso, racchiudiamo gli URL reali in URL permanenti di Listen Notes tramite HTTP 301, ad esempio audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d.

Le app memorizzano comunemente i dati sul client per migliorare le prestazioni. Conservano gli URL permanenti Listen Notes, mentre il nostro server trova gli URL audio corretti e ne controlla continuamente le modifiche.

9. Che cosa facciamo se non troviamo un podcast o se i dati non sono sincronizzati con il feed RSS, ad esempio audio interrotto o metadati errati? 🔗

Anche se il database è molto completo, alcuni nuovi programmi potrebbero non essere aggiunti subito, proprio come Google impiega tempo per trovare e indicizzare nuovi siti. Puoi aiutarci segnalando i programmi mancanti.

Il creatore può inoltre cambiare il feed RSS prima che rileviamo la modifica, oppure il feed può contenere errori. È simile a un risultato Google che porta a una pagina vecchia o 404. Segnala gli errori a hello@listennotes.com: di solito li correggiamo in pochi minuti. Puoi anche usare gli strumenti self-service per correggere i metadati: comportati da bravo cittadino :)

10. Come mantenete aggiornato il database dei podcast? 🔗

Troviamo nuovi podcast in quattro modi.

I crawler cercano 24 ore su 24 i podcast pubblici, come Google trova nuovi siti.
I podcaster inviano nuovi programmi direttamente; ne riceviamo centinaia ogni giorno.
I dipendenti di Listen Notes aggiungono manualmente i podcast mancanti. Più di 2,000,000 persone usano ogni mese listennotes.com e possono segnalare i programmi mancanti. Esaminiamo tutte le proposte e rifiutiamo i podcast falsi.
I principali servizi di hosting si integrano con la nostra Podcast API, consentendo l'invio diretto dei programmi.

Controlliamo tutti i feed RSS senza sosta. Per i podcast ascoltati di recente, i nuovi episodi arrivano entro un'ora, in genere 15–30 minuti. Per gli altri, di solito bastano 2–4 ore.

11. Che cosa succede se violiamo gli API Terms of Use? 🔗

L'account verrà sospeso se violi gli API Terms of Use. Puoi presentare ricorso scrivendo a hello@listennotes.com.

Le due cause più comuni sono: 1. creare più account per aggirare la quota FREE, soprattutto con indirizzi email usa e getta; 2. memorizzare nella cache del server la maggior parte dei dati di risposta. Assicurati di rispettare gli API Terms of Use.

12. Dobbiamo mostrare il logo Listen Notes nell'app anche con un piano a pagamento? 🔗

Sì. Gli API Terms of Use valgono per tutti gli utenti FREE/PRO. È sufficiente mostrare "Powered by Listen Notes" in una schermata che usa i nostri dati, non in tutte.

ENTERPRISE non richiede il logo.

Il player HTML incorporato e Listen API sono prodotti diversi: il logo del player non può essere rimosso neppure con un piano API a pagamento.

13. Possiamo discutere della collaborazione per telefono? 🔗

Listen API è progettata per il self-service. Se in pochi minuti non è chiaro che cosa faccia e come usarla, significa che dobbiamo migliorare il design o la documentazione.

Se è davvero necessario parlare della collaborazione per telefono, scrivi prima a hello@listennotes.com.

14. Posso usare Listen API su piattaforme no-code? 🔗

Sì, purché la piattaforma no-code scelta possa collegarsi a una REST API. Ad esempio, puoi cercare podcast nelle app Bubble e Retool.

Se vuoi soltanto incorporare podcast, episodi, clip o playlist riproducibili nel sito o nel blog, Listen API non serve. Puoi incorporarli facilmente in WordPress, Blogger, Ghost, Google Sites, Tumblr e molte altre piattaforme di pubblicazione.

15. Fornite librerie di Podcast API per specifici linguaggi di programmazione? 🔗

Sì, ne abbiamo alcune. In futuro aggiungeremo librerie per altri linguaggi.

16. Quali informazioni raccoglie Listen Notes dagli utenti dell'API? 🔗

Raccogliamo il minimo indispensabile sul dispositivo che invia direttamente le richieste: 1) indirizzo IP; 2) user-agent; 3) endpoint e parametri. In pratica è una riga dei log di accesso Nginx. Tutto qui.

In una tipica app di podcast, le richieste partono dai server dello sviluppatore, che agiscono da proxy, non dall'app dell'utente. Conosciamo quindi solo IP e user-agent del server, endpoint e parametri; non sappiamo altro sugli utenti finali.

17. Listen API applica dei limiti di frequenza, ad esempio N richieste al secondo? 🔗

Sì. Applichiamo limiti di frequenza ragionevoli. Se usi correttamente l'API potresti non accorgertene.

Ogni REST API seria deve avere limiti: cerca "api rate limit" su Google. Senza limiti sarebbe facile causare un DDoS o inviare troppe richieste con un ciclo, anche infinito. Dal 2017 abbiamo visto questi errori più spesso del previsto. Un utente non deve compromettere il sistema e gli altri utenti.

FREE ha limiti bassi, PRO più alti ed ENTERPRISE i più alti. Gli endpoint hanno limiti diversi in base al carico. I nuovi utenti iniziano con limiti relativamente bassi, aumentati nel tempo.

18. Gestite le richieste di rimozione in base a DMCA, GDPR e leggi simili? 🔗

Sì. Gestiamo le richieste di rimozione dei contenuti. Approfondisci:

Puoi inoltrare le richieste degli utenti tramite DELETE /podcasts/{id}, oppure indirizzarle a hello@listennotes.com.

19. Posso trasmettere legalmente l'audio dei podcast su app o siti usando Listen API? 🔗

Certamente. Puoi trasmettere legalmente l'audio dei podcast su app e siti con Listen API. Scopri di più.

Se l'App Store rifiuta l'app a causa dell'integrazione con la nostra API, siamo pronti ad aiutarti.