1. Adicione o item
Mande uma URL ou handle. A API resolve e cria o item (idempotente por fonte — re-postar a mesma fonte devolve o item existente):type é detectado da fonte: URL de canal → youtube_channel, URL de vídeo →
youtube_video, feed RSS → rss, etc.
2. Sincronize os vídeos de um canal
Um itemyoutube_channel busca os vídeos uma página por vez. Dispare o sync de
uma página (só canais) e passe o cursor retornado em after pra próxima página:
Sincronizar chama a API do YouTube — o custo real é repassado a você.
Normalmente você não precisa sincronizar à mão: um
schedule sincroniza os canais das coleções dele
antes de cada rodada.
3. Liste os vídeos
video_id, título, URL do thumbnail, as coleções a que pertence
e viewer_item_id (o item catalogado por você, se houver).
4. Inspecione o item
GET /v1/items/{id} devolve o item com suas coleções e (pra vídeos) o canal de
origem. Liste tudo que você monitora com GET /v1/items (filtre por
?type=youtube_channel).
Próximo
Transcrever
Transforme um vídeo em texto pesquisável.
Montar um reporter
Analise vídeos novos automaticamente.