Perguntas frequentes sobreListen API

1. Por que razão devo utilizar a Listen API em vez da iTunes API? 🔗

Existem sempre outras opções: criar e manter a sua própria base de dados ou escolher outra API de podcasts disponível na Internet.

Para ajudar a avaliar a Listen API, oferecemos preços simples e transparentes e documentação abrangente de todos os endpoints com respostas JSON de exemplo.

É muito fácil experimentar a Listen API. Não precisa de falar com vendedores nem de pedir uma demonstração: basta subscrever o plano FREE sem indicar um cartão e começar a utilizar a Listen API.

Se subscrever o PRO ou ENTERPRISE, pode enviar qualquer pergunta para hello@listennotes.com e receber rapidamente uma resposta direta do fundador e CEO do Listen Notes.

E a iTunes API da Apple? Leia a documentação e experimente-a. Poderá concluir que não é adequada porque:

não oferece endpoints nem dados estruturados suficientes para funções básicas, como pesquisar todos os episódios, reproduzir áudio ou criar listas — a documentação torna isto evidente em poucos minutos;
devolve poucos resultados de podcasts e a ordenação está longe de ser ideal;
os termos de utilização podem não permitir o que pretende fazer;
provavelmente não é mantida nem melhorada ativamente pelos melhores funcionários, pois não é um produto importante para a Apple Inc.;
numa API empresarial, o apoio prestado por pessoas, como engenheiros de suporte, costuma fazer parte do serviço — será difícil obter respostas rápidas e úteis dos funcionários da Apple.

Este artigo também poderá ser útil: Como avaliar uma REST API externa?

2. Qual é a dificuldade de criar uma base de dados de podcasts? 🔗

Criar uma boa base de dados de podcasts exige trabalho contínuo. Não é difícil, mas requer tempo e dinheiro para servidores, salários de engenheiros e manutenção. Tal como um carro ou uma casa, o custo inicial é muito inferior aos custos permanentes: impostos, seguros, reparações inesperadas e, sobretudo, o seu tempo.

Antes de criar e manter a sua própria base, considere:

Existem pelo menos 3,831,088 podcasts e 196,732,836 episódios na Internet, e o volume cresce cada vez mais depressa. Terá de alojar os dados e mantê-los atualizados.
À escala de 3,831,088 podcasts e 196,732,836 episódios, os feeds RSS e URLs de áudio mudam com mais frequência do que imagina. É necessário investir em ferramentas automáticas e processos manuais contínuos para limpar dados — trabalho essencial, mas invisível para os utilizadores.
Para pesquisar 3,831,088 podcasts e 196,732,836 episódios por palavras-chave, precisa de construir um motor de pesquisa. A interface pode parecer simples, mas a infraestrutura de backend é extremamente complexa. Há uma razão para o Google, um “site simples”, ter empregado 175 000 pessoas a tempo inteiro em 2022, além de centenas de milhares de prestadores.
Há muitos podcasts falsos na Internet, incluindo áudio gerado por máquinas. Profissionais de black-hat SEO criam-nos em massa para obter ligações; não são feitos para ouvintes humanos. Precisa de processos automáticos e manuais para os eliminar. Curiosidade: o Google tem uma equipa dedicada ao spam, e o Listen Notes também dedica muitos recursos aos podcasts falsos.
Se a base e o motor de pesquisa tiverem de funcionar continuamente, será necessário prevenir e resolver interrupções dos servidores.
Quanto custa um bom engenheiro de software a tempo inteiro? Prefere pagar por um serviço externo, como a nossa API, ou os salários de vários engenheiros internos?

Na verdade, a parte mais cara de uma base própria é o custo de oportunidade. É uma escolha: o tempo gasto na base não pode ser utilizado para criar a sua aplicação ou site.

A Listen API permite começar imediatamente pela parte mais interessante do projeto. Também gerimos em listennotes.com um popular motor de pesquisa, utilizado por mais de 2,000,000 pessoas por mês. Esses utilizadores ajudam a manter a base atualizada, por exemplo, ao submeter podcasts em falta e corrigir dados incorretos. Com a ajuda contínua de pessoas de todo o mundo, conseguimos manter uma base de elevada qualidade.

3. Continuam a manter ativamente a API e tencionam fazê-lo no futuro? 🔗

Sim a ambas as perguntas.

A Listen API alimenta o nosso site público ListenNotes.com e beneficia da maioria das melhorias feitas ao backend do site.

Estamos no mercado desde 2017 e pretendemos continuar por muito tempo.

4. O que acontece se adotarmos a Listen API e esta for descontinuada no futuro? 🔗

A preocupação é válida: nenhum serviço ou empresa online dura para sempre. Por exemplo, o Google encerrou muitos produtos próprios.

Se decidirmos encerrar a Listen API, avisaremos com pelo menos 12 semanas de antecedência e poderá comprar a cópia mais recente da base, com todos os podcasts e episódios, por um preço razoavelmente baixo.

O Listen Notes provavelmente sobreviverá a muitas startups bem financiadas e até a empresas cotadas. Mantemos uma operação enxuta. Ao contrário de empresas maiores, não temos uma enorme folha salarial, tornando improvável um encerramento por disputas internas. Concebemos uma infraestrutura robusta sem desperdiçar dinheiro em servidores.

5. Prestam apoio técnico? 🔗

Sim. Se subscrever o PRO ou ENTERPRISE, envie perguntas sobre a API para hello@listennotes.com. Por vezes respondemos a utilizadores FREE, mas damos prioridade aos clientes PRO e ENTERPRISE.

Em vez de passar por um apoio ao cliente impessoal, falará diretamente com o fundador e CEO da Listen Notes, Inc., que criou todo o produto com as próprias mãos e muita dedicação.

6. Faremos muitos pedidos à API. Conseguem suportar a nossa escala? 🔗

Algumas empresas fazem atualmente dezenas de milhões de pedidos por mês através da Listen API. Conseguimos suportar facilmente dez vezes mais tráfego sem acrescentar servidores.

Aplicamos boas práticas operacionais, com monitorização e alertas abrangentes. Se surgir um problema na infraestrutura, conseguimos diagnosticá-lo e corrigi-lo rapidamente. Temos um excelente histórico de desempenho e disponibilidade.

7. Podemos guardar a resposta da API em cache no cliente, por exemplo, na aplicação ou no navegador? 🔗

Sim. Os nossos API Terms of Use (planos FREE e PRO) permitem guardar respostas em cache no cliente, mas não no servidor, exceto os ids de podcasts/episódios e pub_dates.

Assim, no servidor, por exemplo na sua base de dados, só pode guardar permanentemente ids e pub_dates. Esta política é comum em API de dados, como a Google Maps API (pesquise “No Scraping”).

Pode guardar e processar os próprios ficheiros de áudio no servidor, por exemplo para criar clipes ou transcrições.

Com o plano ENTERPRISE, pode guardar as respostas completas nos seus servidores.

8. Por que razão os URLs de áudio nas respostas da API pertencem ao domínio listennotes.com? 🔗

Para esclarecer: não alojamos áudio nos nossos servidores. Os podcasters recebem dados analíticos exatos, como IP e user-agent do ouvinte.

Encapsulamos os URLs reais nos nossos próprios URLs através de HTTP 301, por exemplo audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d, porque os podcasts mudam frequentemente os URLs de áudio. Assim, ajudamos os utilizadores a encontrar sempre o endereço correto.

É comum as aplicações guardarem dados em cache no cliente para melhorar o desempenho. Guardam o URL permanente do Listen Notes, enquanto nós determinamos no servidor o URL de áudio atual e verificamos continuamente as alterações.

9. E se não encontrarmos um podcast ou os dados não estiverem sincronizados com o feed RSS, por exemplo, áudio quebrado ou metadados incorretos? 🔗

Embora a base seja muito abrangente, por vezes um novo programa pode não ser adicionado a tempo. Tal como no Google, os crawlers precisam de tempo para encontrar e indexar novos conteúdos. Nesse caso, pode submeter o programa em falta.

O criador também pode alterar o feed RSS sem que detetemos logo a mudança, ou o feed pode conter erros. É semelhante a resultados antigos ou páginas 404 no Google: a correção demora algum tempo. Comunique erros de metadados para hello@listennotes.com e corrigi-los-emos rapidamente, normalmente em minutos. Também pode utilizar as nossas ferramentas autónomas para corrigir os dados — ajude-nos a manter a qualidade :)

10. Como garantem que a base de dados de podcasts está atualizada? 🔗

Encontramos novos podcasts de quatro formas.

Primeiro, os nossos crawlers procuram continuamente podcasts públicos na Internet, tal como o Google encontra novos sites.
Segundo, os podcasters submetem novos programas ao Listen Notes — recebemos centenas por dia.
Terceiro, os funcionários do Listen Notes adicionam manualmente os podcasts em falta. Também gerimos o popular motor de pesquisa listennotes.com, utilizado por mais de 2,000,000 pessoas por mês. Qualquer pessoa pode submeter um programa em falta, ajudando a manter a base abrangente e atualizada. Analisamos cada submissão manualmente e rejeitamos podcasts falsos, como áudio gerado por máquinas.
Quarto, colaboramos com os principais serviços de alojamento, que integram a nossa Podcast API para permitir submissões diretas.

Verificamos continuamente os feeds RSS. Para podcasts ouvidos recentemente através do site ou da API, adicionamos novos episódios no prazo de uma hora, normalmente em 15 a 30 minutos. Nos restantes casos, são obtidos em poucas horas, habitualmente entre duas e quatro.

11. O que acontece se violarmos os API Terms of Use? 🔗

A conta será suspensa se violar os nossos API Terms of Use. Pode recorrer por e-mail: hello@listennotes.com.

Os dois motivos mais comuns de suspensão são: 1. criar várias contas para contornar a quota do plano FREE, sobretudo com endereços de e-mail descartáveis; 2. guardar em cache no servidor a maior parte dos dados das respostas. Certifique-se de que cumpre os API Terms of Use.

12. Temos de mostrar o logótipo do Listen Notes na aplicação mesmo com um plano pago? 🔗

Sim. Os nossos API Terms of Use aplicam-se a todos os utilizadores FREE e PRO. Só precisa de mostrar “Powered by Listen Notes” num ecrã que utilize os nossos dados, não em todos. Pode colocar o logótipo abaixo da dobra para que seja discreto.

Não abrimos exceções para utilizadores FREE ou PRO, sejam programadores individuais ou empresas cotadas. Personalizações pontuais aumentariam a complexidade operacional e retirariam tempo à melhoria dos produtos principais.

A atribuição é comum em API de dados, como nas API Google Places e Maps. A Uber utiliza Google Maps e mostra um grande logótipo Google na aplicação.

No plano ENTERPRISE, podemos ser flexíveis quanto ao logótipo.

13. Podemos conversar por telefone sobre uma parceria? 🔗

A Listen API foi concebida para ser autónoma. Se não conseguir perceber em poucos minutos o que faz e como utilizá-la, significa que não explicámos bem. Se tiver perguntas, comecemos por e-mail: hello@listennotes.com.

Receberá uma resposta informativa por e-mail muito mais depressa do que conseguiria agendar uma chamada.

14. Posso utilizar a Listen API em plataformas no-code? 🔗

Sim, desde que a plataforma no-code escolhida permita a ligação a uma REST API. Por exemplo, pode utilizar a Listen API para pesquisar podcasts em aplicações criadas com Bubble e Retool.

Se apenas pretende incorporar podcasts, episódios, clipes ou listas reproduzíveis num site ou blogue, não precisa da Listen API. Pode incorporá-los facilmente no WordPress, Blogger, Ghost, Google Sites, Tumblr e muitas outras plataformas.

15. Disponibilizam bibliotecas da Podcast API para linguagens de programação específicas? 🔗

Sim. Já disponibilizamos algumas bibliotecas e, no futuro, adicionaremos suporte para mais linguagens.

16. Que informações recolhe o Listen Notes sobre os utilizadores da API? 🔗

Recolhemos o mínimo de informação sobre o dispositivo que envia diretamente pedidos aos nossos servidores: 1) endereço IP; 2) user-agent; 3) endpoint e parâmetros. É essencialmente uma linha dos registos de acesso do Nginx. Nada mais.

Por exemplo, um programador cria uma aplicação de podcasts e vários utilizadores ouvem através dela. Normalmente, os pedidos partem dos servidores do programador, que funcionam como intermediários entre a aplicação e a Listen API. Assim, apenas registamos 1) os IP dos servidores; 2) o respetivo user-agent, como python-requests; 3) os endpoints e parâmetros. Não sabemos mais nada sobre os utilizadores finais.

17. A Listen API tem limites de frequência, como N pedidos por segundo? 🔗

Sim. Definimos limites de frequência razoáveis para os endpoints. Se utilizar corretamente a API, talvez nem note que existem.

Todas as REST API sérias precisam destes limites — pesquise “api rate limit”. Sem eles, uma API seria facilmente alvo de DDoS. Um programador pode enviar inúmeros pedidos num ciclo apertado ou infinito. Desde 2017, isto aconteceu mais vezes do que esperávamos. Os programadores são humanos e cometem erros. Não queremos que um utilizador derrube o sistema e afete os restantes.

O plano FREE tem um limite baixo, o PRO um mais alto e o ENTERPRISE o mais elevado. Os limites variam por endpoint, pois alguns exigem mais processamento. Novos utilizadores começam com valores relativamente baixos, que aumentam ao longo do tempo.

18. Tratam pedidos de remoção de podcasts ao abrigo da DMCA, do RGPD e de legislação semelhante? 🔗

Sim. Tratamos pedidos de remoção de conteúdo. Saiba mais:

Pode encaminhar pedidos em nome dos seus utilizadores através do endpoint DELETE /podcasts/{id} ou enviá-los para hello@listennotes.com.

19. Posso transmitir legalmente áudio de podcasts nas minhas aplicações ou sites com a Listen API? 🔗

Sim. Pode transmitir legalmente áudio de podcasts nas suas aplicações ou sites através da Listen API. Saiba mais.

Se a App Store rejeitar a aplicação devido à integração com a nossa API, estamos disponíveis para ajudar.