Dicas de como utilizar a API do iTunes para construir um agregador de podcasts

Vinícius Veríssimo
3 min readMay 31, 2018

--

Eu sei que já é manjado utilizar a API do iTunes para pegar os metadados dos podcasts cadastrados lá, mas geralmente quem está começando a procurar sobre isso pode ter algumas dúvidas que são básicas quando você está fazendo algo como um agregador de podcasts. Vou dar umas dicas que ajudam bastante.

Já estou presumindo que você deu uma olhada na documentação da API.

Top podcasts do momento

O RSS Generator te possibilita criar um feed personalizado para as diferentes mídias do iTunes, dentre elas podcast, claro.

RSS Feed Generator

Depois de selecionar os parâmetros, é só utilizar a URL gerada para receber o JSON dos principais podcasts do momento, ou seja, de tempos em tempos esse JSON muda.

Dá para utilizar essa URL como base e mudar o país e a quantidade de resultados dinamicamente na sua aplicação.

Fazendo uma requisição GET para essa URL, o JSON recebido é algo como:

Um dos campos é o id, que pode ser usado para conseguir mais dados do podcast no iTunes.

Buscando podcasts pelo ID

É bem simples, basta fazer outra requisição GET para essa URL abaixo utilizando o id do podcast como parâmetro.

https://itunes.apple.com/lookup?id=PODCAST_ID

O resultado será algo como:

Buscando podcasts pelo nome

Para buscar pelo nome tem que lembrar de definir o tipo de entidade que queremos, no caso é podcast.

https://itunes.apple.com/search?term=PODCAST_NAME&entity=podcast

Vale lembrar que o nome de ser uma string no formato URL-encoded.

O retorno é um JSON com uma lista de todos os podcasts que são resultado para a busca daquele termo. Considerando o JSON anterior como um objeto do tipo Podcast, o resultado da busca será um array desses objetos do tipo Podcast.

Feed do podcast

Pelo feed do podcast é que você consegue todas as informações dos episódios, inclusive o link para download.

Como você pode ver no resultado da busca de podcast pelo id, um dos campos do JSON é o feedURL, esse é o link do feed cadastrado para aquele podcast.

Umas dicas sobre vasculhar o feed: ele é um arquivo XML e dependendo da quantidade de episódios do podcast, ele pode ser um pouco pesado, chegando na casa do mb, o que pode ser ruim caso ele seja acessado do lado do usuário, nunca se sabe se o usuário está numa conexão boa, outro problema é que, diferente do JSON do iTunes, o feed não tem um padrão, algumas informações se repetem como metatags usadas pelo iTunes e outros agregadores e plataformas, mas nem todo feed possuirá as mesma metatags.

Então tenha duas coisas em mente:

  • A obtenção do feed pode demorar em conexões mais lentas;
  • Não se baseie em apenas um feed para tratar todos;

É com você agora!

Essas dicas já são suficientes para você ter uma base para construir o seu próprio agregador de podcasts, você já tem os dados agora é com você!

Se esse post te ajudou de alguma forma comenta aí embaixo 😉

🐙 Github

👤 Lattes

👦 LinkedIn

--

--

Vinícius Veríssimo

Bacharel em Ciência da Computação pela UFPB. Estudante de Mestrado em Computação na UFPB.