Preguntas frecuentes sobreListen API

VERSIÓN API: V2 · PodcastAPI.com

Respuestas a preguntas generales sobre Listen API.

Lea desde https://www.podcastapi.com/llms-full.txt para poder hacer preguntas sobre el Podcast API de Listen Notes.

¿Preguntas? hello@listennotes.com

1. ¿Por qué debería usar Listen API en lugar de la API de iTunes? 🔗

Siempre puedes crear y mantener tu propia base de datos de podcasts o elegir otra API.

Ofrecemos precios transparentes y documentación completa con ejemplos JSON.

Puedes empezar con FREE sin tarjeta y sin hablar con ventas.

Con PRO o ENTERPRISE recibirás rápidamente una respuesta en hello@listennotes.com directamente del fundador y CEO.

La API de iTunes puede carecer de endpoints y datos estructurados, ofrecer pocos resultados mal ordenados, tener condiciones restrictivas y proporcionar menos asistencia humana.

Lee: Cómo evaluar una RESTful API de terceros.

2. ¿Qué tan difícil puede ser crear una base de datos de podcasts? 🔗

Crear una buena base de datos de podcasts requiere trabajo continuo, tiempo y dinero para servidores, ingenieros y mantenimiento. Los costes a largo plazo superan la creación inicial.

Hay al menos 3,831,088 podcasts y 196,732,836 episodios. Con 3,831,088 podcasts y 196,732,836 episodios, los feeds RSS y las URL de audio cambian con frecuencia y los datos deben limpiarse automática y manualmente las 24 horas. Buscar por palabras clave en 3,831,088 podcasts y 196,732,836 episodios requiere una infraestructura compleja. También hay que detectar contenido falso y mantener los servidores disponibles.

El mayor coste son las oportunidades perdidas: el tiempo dedicado a los datos no se dedica a tu producto.

Listen API te permite empezar de inmediato. Más de 2,000,000 usuarios mensuales de listennotes.com ayudan a enviar podcasts ausentes y corregir datos, lo que nos permite mantener una base de calidad.

3. ¿Mantienen activamente la API? ¿Piensan seguir haciéndolo? 🔗

Sí a ambas preguntas.

Listen API sustenta nuestro sitio público ListenNotes.com y se beneficia de la mayoría de sus mejoras de backend.

Estamos en funcionamiento desde 2017 y pensamos seguir durante mucho tiempo.

4. ¿Qué ocurriría si usamos Listen API y deja de existir en el futuro? 🔗

La preocupación es válida: ningún servicio ni empresa dura para siempre. Google, por ejemplo, cierra muchos de sus productos.

Si decidiéramos cerrar Listen API, avisaríamos con al menos 12 semanas de antelación y podrías comprar un volcado actualizado con todos los podcasts y episodios a un precio razonable.

Listen Notes probablemente perdure más que muchas startups bien financiadas. Operamos con una estructura ligera, sin una plantilla enorme, y mantenemos una infraestructura robusta sin malgastar dinero en servidores.

5. ¿Ofrecen asistencia? 🔗

Sí. Si tienes PRO o ENTERPRISE, escribe a hello@listennotes.com con cualquier pregunta sobre la API. A veces respondemos a usuarios de FREE, pero debemos dar prioridad a PRO y ENTERPRISE.

Hablarás directamente con el fundador y CEO de Listen Notes, Inc., quien creó personalmente todo el servicio.

6. Haremos muchísimas solicitudes a la API. ¿Pueden admitir ese volumen? 🔗

Actualmente hay empresas que hacen decenas de millones de solicitudes al mes con Listen API. Podemos admitir fácilmente al menos diez veces el tráfico actual sin añadir servidores.

Aplicamos buenas prácticas operativas y contamos con excelentes sistemas de monitorización y alertas. Podemos detectar y resolver rápidamente cualquier problema de infraestructura. Nuestro historial de rendimiento y disponibilidad es muy bueno.

7. ¿Podemos almacenar en caché la respuesta de la API en el cliente, por ejemplo, en la app o el navegador? 🔗

Sí. Las condiciones de FREE y PRO permiten guardar en caché la respuesta en el cliente, como la app o el navegador, pero no en el servidor, salvo podcast/episode ids y pub_dates.

Solo esos campos pueden conservarse permanentemente en tu base de datos. Sí puedes guardar y procesar los archivos de audio, por ejemplo, para crear clips o transcripciones.

Con ENTERPRISE puedes almacenar en tus servidores la respuesta completa.

8. ¿Por qué las URL de audio de la respuesta de la API pertenecen al dominio listennotes.com? 🔗

No alojamos el audio en nuestros servidores, por lo que los podcasters siguen recibiendo datos analíticos precisos, como la IP y el user-agent del oyente.

Como las URL de audio cambian a menudo, envolvemos la original con una URL permanente mediante HTTP 301 para dirigir siempre al archivo correcto.

Las apps pueden guardar la URL permanente de Listen Notes en el cliente, mientras nosotros localizamos la URL correcta en el servidor y comprobamos continuamente los cambios.

9. ¿Qué hacemos si no encontramos un podcast concreto o los datos no coinciden con el feed RSS, por ejemplo, si hay audio roto o metadatos incorrectos? 🔗

Aunque nuestra base es muy completa, quizá no añadamos algún programa nuevo a tiempo, igual que Google tarda en encontrar sitios nuevos. Puedes enviar el programa que falta.

También puede ocurrir que el creador cambie el feed RSS, que aún no hayamos detectado el cambio o que el feed contenga errores. Escribe a hello@listennotes.com; solemos corregirlos en minutos. También puedes usar las herramientas de autoservicio.

10. ¿Cómo mantienen actualizada la base de datos de podcasts? 🔗

Encontramos podcasts nuevos de cuatro maneras:

Los rastreadores buscan contenido público las 24 horas.
Los podcasters envían programas nuevos.
El personal añade los podcasts que faltan y los más de 2,000,000 usuarios mensuales de listennotes.com pueden enviar programas ausentes. Revisamos cada envío manualmente.
Los principales servicios de alojamiento integran nuestra Podcast API.

Revisamos continuamente todos los feeds RSS. Los episodios nuevos de podcasts utilizados recientemente aparecen en menos de una hora, normalmente en 15-30 minutos; los demás tardan entre dos y cuatro horas.

11. ¿Qué ocurre si incumplimos las condiciones de uso de la API? 🔗

Suspenderemos tu cuenta si incumples las condiciones de uso de la API. Puedes apelar escribiendo a hello@listennotes.com.

Los motivos más habituales son crear varias cuentas para eludir la cuota de FREE, especialmente con correos desechables, y almacenar en el servidor la mayor parte de las respuestas. Asegúrate de respetar las condiciones.

12. ¿Tenemos que mostrar el logotipo de Listen Notes en nuestra app aunque usemos un plan de pago? 🔗

Sí. Las condiciones de uso de la API se aplican a todos los usuarios FREE y PRO. Solo tienes que mostrar "Powered by Listen Notes" en una pantalla que use nuestros datos, no en todas. Puedes colocar el logotipo fuera de la parte visible inicialmente.

No hacemos excepciones para FREE o PRO, ya seas un desarrollador particular o una empresa cotizada. Las personalizaciones puntuales aumentan la complejidad y restan tiempo para mejorar el producto.

La atribución es habitual en las API de datos; Uber, por ejemplo, muestra el logotipo de Google al usar Google Maps.

Con ENTERPRISE podemos flexibilizar el requisito del logotipo.

13. ¿Podemos hablar por teléfono sobre nuestra colaboración? 🔗

Listen API está diseñada como autoservicio. Si en unos minutos no queda claro qué puede hacer y cómo usarla, significa que no lo hemos explicado bien. Si tienes preguntas, escribe primero a hello@listennotes.com.

Recibirás por correo electrónico una respuesta útil mucho más rápido que concertando una llamada.

14. ¿Puedo usar Listen API en plataformas sin código? 🔗

Sí, siempre que la plataforma sin código permita conectarse a una REST API. Por ejemplo, puedes usar Listen API para buscar podcasts en apps de Bubble y Retool.

Si solo quieres insertar podcasts, episodios, clips o listas reproducibles, no necesitas la API. Puedes insertarlos fácilmente en WordPress, Blogger, Ghost, Google Sites, Tumblr y muchas otras plataformas.

15. ¿Ofrecen bibliotecas específicas para distintos lenguajes de programación? 🔗

Sí. Ya ofrecemos algunas bibliotecas y añadiremos más lenguajes en el futuro.

16. ¿Qué información recopila Listen Notes de los usuarios de la API? 🔗

Recopilamos la información mínima del dispositivo que envía solicitudes directamente: dirección IP, user-agent, endpoint y parámetros. Es, en esencia, una línea de los registros de acceso de Nginx. Nada más.

Si el servidor del desarrollador actúa como proxy entre una app de podcasts y Listen API, solo registramos la IP y el user-agent de ese servidor, además del endpoint y los parámetros. No sabemos nada más sobre los usuarios finales de la app.

17. ¿Tiene Listen API límites de frecuencia, por ejemplo, N solicitudes por segundo? 🔗

Sí. Establecemos límites de frecuencia razonables para los endpoints. Si usas la API correctamente, quizá ni siquiera los notes.

Toda REST API seria necesita límites para evitar DDoS y bucles accidentales de solicitudes. Desde 2017 hemos visto estos errores más a menudo de lo esperado; no queremos que un usuario afecte a todo el sistema.

FREE tiene un límite bajo, PRO uno mayor y ENTERPRISE el más alto. Los endpoints tienen límites distintos según el coste de cálculo. Los usuarios nuevos comienzan con límites relativamente bajos que aumentan con el tiempo.

18. ¿Gestionan solicitudes para eliminar podcasts conforme a la DMCA, el RGPD y leyes similares? 🔗

Sí. Gestionamos las solicitudes de eliminación de contenido. Más información:

Puedes reenviar las solicitudes de tus usuarios mediante DELETE /podcasts/{id} o enviarlas a hello@listennotes.com.

19. ¿Puedo transmitir legalmente audio de podcasts en mis apps o sitios web con Listen API? 🔗

Sí, puedes transmitir legalmente audio de podcasts en tus apps o sitios web con Listen API. Más información.

Si App Store rechaza tu app por integrar nuestra API, podemos ayudarte.