Pular para o conteúdo
v1.0GET https://legendas.online/api/v1

API

A API do legendas.online permite que sites parceiros, players e plugins (Stremio, Kodi, Bazarr e afins) busquem e baixem legendas. Todas as respostas são JSON em UTF-8, menos os downloads.

Usa o Stremio? O addon pronto está em https://legendas.online/stremio, sem precisar de chave.

Autenticação

Envie a credencial em todas as requisições, no cabeçalho:

Authorization: Bearer SUA_CHAVE
  • Token pessoal (lo_u_…): para apps e plugins que você usa. Crie em Minha conta → Apps e plugins. Limite de 60 requisições por minuto.
  • Chave de cliente (lo_c_…): para sites parceiros, entre servidores. Fornecida pela administração.

Os cabeçalhos X-RateLimit-Limit e X-RateLimit-Remaining mostram o limite. Ao passar dele, a resposta é 429 com Retry-After.

Endpoints

EndpointO que faz
GET /api/v1Confere a credencial, mostra a versão e os idiomas aceitos.
GET /api/v1/titulos?q=Busca filmes e séries pelo nome (original, inglês ou no Brasil) ou pelo código do IMDb.
GET /api/v1/titulos/{imdb}Dados do título; em séries, quantos episódios de cada temporada têm legenda. Aceita também tvdb:serie:123 e tvdb:filme:123.
GET /api/v1/legendasLegendas de um filme, episódio ou temporada inteira (veja abaixo).
GET /api/v1/legendas/{id}Uma legenda específica.
GET /api/v1/legendas/{id}/baixarO arquivo. formato=srt|vtt converte; atraso=1500 (ms, pode ser negativo) ajusta o tempo.
GET /api/v1/pacote.zip com a melhor legenda de cada episódio de uma temporada (imdb, temporada, idioma, release). Só quando todos os episódios da temporada têm legenda; antes disso responde 409.
GET /api/v1/novidades?desde=Legendas aprovadas depois de uma data, para manter um cache em dia.

Buscar legendas

GET https://legendas.online/api/v1/legendas?imdb=tt1234567&temporada=2&episodio=5&idioma=pt-BR&release=Nome.Do.Video.S02E05.1080p.WEB-DL-GRUPO
  • imdb: código do IMDb do filme ou da série (para séries, sempre o da série, não o do episódio).
  • temporada e episodio: para séries. Só com temporada, vem a temporada inteira, mais um link pacote para o .zip quando a temporada estiver completa.
  • idioma: pt-BR, pob, por, pt, en, eng… Separe vários por vírgula. Sem ele, vêm todos.
  • release: nome do arquivo de vídeo. Cada legenda ganha combina (exato, provavel ou outra_versao, com nota de 0 a 100), e a lista vem da mais compatível para a menos.

Título desconhecido ou sem legendas devolve 200 com a lista vazia, não erro.

Resposta (resumida):

{
  "titulo": { "imdb": "tt1234567", "tipo": "serie", "nome": "Nome Original", "nome_br": "Nome no Brasil", "ano": 2025, ... },
  "legendas": [
    {
      "id": 42, "temporada": 2, "episodio": 5,
      "idioma": { "codigo": "pt-BR", "iso639_1": "pt", "iso639_2": "por", "opensubtitles": "pob" },
      "release": "Nome.Do.Video.S02E05.1080p.WEB-DL-GRUPO",
      "combina": { "nivel": "exato", "nota": 100 },
      "formato": "srt", "fps": "23.976", "sdh": false, "recomendada": true,
      "equipe": { "nome": "...", "oficial": true },
      "links": {
        "baixar": "https://legendas.online/api/v1/legendas/42/baixar?exp=...&cred=...&sig=...",
        "baixar_srt": "...", "baixar_vtt": "...",
        "pagina": "https://legendas.online/serie/..."
      }
    }
  ]
}

Links de download

Os links em links são assinados e valem 1 hora: o app (ou o navegador do usuário) baixa sem enviar a credencial. Depois disso, peça a lista de novo para gerar links novos. Também dá para baixar enviando a credencial no cabeçalho, sem link assinado. Cada legenda conta um download por dia por credencial.

Novidades

GET https://legendas.online/api/v1/novidades?desde=2026-10-27T00:00:00-03:00&idioma=pt-BR&limite=100

Legendas aprovadas depois da data, das mais antigas às mais novas. Na chamada seguinte, envie desde e depois_de_id que vêm em proximo. Repita enquanto tem_mais for true.

Erros

{ "erro": { "codigo": "nao_autenticado", "mensagem": "..." } }

Códigos HTTP: 400 parâmetro inválido, 401 sem credencial ou credencial inválida, 403 assinatura inválida, 404 não encontrado, 410 link expirado, 429 limite excedido.

Para quem cria plugins

  • O Stremio identifica episódios por tt1234567:2:5: separe e use imdb, temporada e episodio.
  • Players que só leem .srt ou .vtt: use links.baixar_srt ou links.baixar_vtt, que convertem legendas .ass na hora.
  • A API aceita requisições de outros sites (CORS liberado).
  • Para abrir a página de um título no site a partir do IMDb: https://legendas.online/imdb/tt1234567 ou /imdb/tt1234567/2/5 para um episódio.