A API do Seedr está se abrindo

A mesma API que executa nossas integrações Sonarr, Radarr, Roku e Kodi agora está disponível mediante solicitação para qualquer usuário Premium ou V2. Sem formulários longos, sem fila de revisão caso a caso. Envie um e-mail para o suporte, nós ativamos, você constrói.

Por que construímos isso

A API do Seedr tem alimentado silenciosamente tudo por um tempo. As integrações da pilha *arr se comunicam com ela. Os novos aplicativos Roku e Kodi se comunicam com ela. Algumas integrações futuras que ainda não anunciamos se comunicam com ela. É o mesmo pipeline de produção em todos os casos.

Originalmente, nós a restringíamos rigidamente: diga-nos o que você quer construir, e nós habilitávamos o acesso manualmente. Isso fazia sentido quando a API era jovem e precisávamos saber exatamente o que estava atingindo qual endpoint. Fez menos sentido depois que ela se estabilizou.

A dor que forçou uma mudança:

  • Autores de plugins queriam prototipar durante um fim de semana, não enviar e-mail e esperar.
  • Entusiastas de home-lab tiveram uma ideia de painel às 2h da manhã e perderam o ritmo até segunda-feira.
  • Parceiros de integração queriam uma história previsível que pudessem documentar.

Então paramos de restringir por caso de uso e começamos a restringir por plano. Mais simples para você. Mais simples para nós.

O que mudou

Antes: Aprovação por projeto. Descreva seu caso de uso. Espere por um humano.

Agora:

  • Premium ou V2? Envie um e-mail para o suporte com o assunto exato: "API access". Nós o ativamos em sua conta.
  • Mesmos endpoints que nossos plugins usam. Sem sandbox, sem ambiente de teste separado. Você está acessando a produção desde a primeira solicitação.
  • Mesmos limites de taxa e comportamentos contra os quais nossas próprias integrações são executadas. Se funciona para Sonarr, funcionará para sua ferramenta.
  • Não é Premium, mas está construindo algo real? Envie um e-mail de qualquer forma. Nós lemos e fazemos exceções para projetos genuínos.

O que a API realmente faz

Versão curta: tudo o que a interface web do Seedr pode fazer, a API pode fazer. Isso inclui:

  • Adicionar links de download e URLs à sua conta.
  • Listar, mover, renomear e excluir arquivos e pastas.
  • Obter URLs de streaming direto para reprodução ou transmissão.
  • Ler o estado da conta (armazenamento usado, transferências ativas, histórico concluído).
  • Gerenciar pastas como objetos estruturados (não apenas caminhos).

É a mesma API que nossos conectores Sonarr e Radarr usam, então se você viu essas ferramentas funcionando, você viu o que a API pode fazer.

Como usá-lo hoje

Três passos.

  1. Confirme seu plano. Você precisa estar em um plano pago (Basic, Pro, Master ou Gold) ou no V2 alpha. Contas gratuitas não são elegíveis por padrão. Faça upgrade em /pricing se necessário.
  2. Envie um e-mail para o suporte. Do e-mail da sua conta Seedr, envie uma mensagem para support@seedr.cc com o assunto exatamente: API access. Uma frase curta sobre o que você está construindo ajuda, mas não é obrigatória para usuários Premium.
  3. Nós o ativamos em sua conta. Você receberá um e-mail de confirmação com um link para a documentação e suas credenciais. O tempo de resposta é geralmente de 1 dia útil.

Depois disso:

  • Leia a documentação dos endpoints.
  • Escreva sua primeira solicitação contra sua própria conta.
  • Construa.

Se você estiver prototipando um plugin público ou uma integração compartilhada, informe-nos no e-mail. Estaremos atentos a casos extremos em sua conta e o avisaremos se algo na API mudar de forma disruptiva.

Roteiro

O que vem a seguir:

  • Chaves de autoatendimento na interface da conta para que você não precise nos enviar e-mail.
  • Escopos por chave para que você possa emitir uma chave somente leitura para uma ferramenta e uma chave de acesso total para outra.
  • Suporte a Webhook para eventos como "salvamento concluído" ou "armazenamento 90% cheio".
  • Especificação OpenAPI pública para bibliotecas de cliente autogeradas.

Limite honesto: a API é apenas para produção. Ainda não há um sandbox público. Se você precisar testar sem tocar em sua conta real, use uma conta gratuita para desenvolvimento e sua conta principal para produção.

Construa a coisa

Gostamos de ver o que as pessoas fazem com isso. Se você construir algo que valha a pena compartilhar, avise-nos e o ajudaremos a alcançar nossa comunidade.

21 de novembro de 2025