CYNE API — Documentação

Referência

Endpoints

GET /api/v1 Status e créditos ⌄

Retorna status das APIs, créditos do criador e lista de todos os endpoints disponíveis.

          
          // Request
          GET /api/v1
           
          // Response
          "status": "online",
          "gateway": "CYNEBLACK API Gateway",
          "apis": { "tmdb": { "status": "ONLINE" }, "omdb": { ... } }
        

GET /api/v1/search Busca com filtros ⌄

Param	Tipo	Default	Descrição
q *	string	—	Texto de busca
type	string	multi	multi \| movie \| tv \| person
year	number	—	Filtro de ano
language	string	pt-BR	Idioma dos resultados
page	number	1	Página
sort_by	string	—	popularity.desc \| vote_average.desc \| release_date.desc
region	string	BR	Região (BR, US, PT...)
field	string	—	Retorna só um campo de cada resultado

          /api/v1/search?q=matrix&type=movie
          /api/v1/search?q=matrix&sort_by=vote_average.desc
          /api/v1/search?q=attack on titan&type=tv&year=2013
          /api/v1/search?q=inception&language=en-US&field=poster_path
        

GET /api/v1/id/[tmdb_id ou tt...] Detalhes por ID ⌄

Aceita ID numérico do TMDB ou ID do IMDB (tt...). Detecta automaticamente se é filme ou série.

Param	Tipo	Default	Descrição
type	string	movie	movie \| tv (só para TMDB numérico)
language	string	pt-BR	Idioma
field	string	—	Retorna um campo: `?field=title`
fields	string	—	Múltiplos campos: `?fields=title,poster_path`
append	string	—	append_to_response: credits, videos, keywords...
omdb	bool	false	Enriquece com IMDb rating, Rotten Tomatoes, etc

          /api/v1/id/550                          ← Fight Club (TMDB)
          /api/v1/id/tt0137523                    ← Fight Club (IMDB, auto-detecta)
          /api/v1/id/1396?type=tv                 ← Breaking Bad
          /api/v1/id/550?field=title              ← { "title": "Fight Club" }
          /api/v1/id/550?fields=title,poster_path,vote_average
          /api/v1/id/550?append=credits,videos,keywords
          /api/v1/id/tt0137523?omdb=true          ← + IMDb rating, BoxOffice...
        

GET /api/v1/id/[id]/similar Títulos similares ⌄

Param	Tipo	Default	Descrição
type	string	movie	movie \| tv
mode	string	similar	similar \| recommendations
page	number	1	Página
language	string	pt-BR	Idioma

          /api/v1/id/550/similar?type=movie
          /api/v1/id/1396/similar?type=tv&mode=recommendations
        

GET /api/v1/trending Em alta ⌄

Param	Tipo	Default	Descrição
media	string	all	all \| movie \| tv \| person
window	string	week	day \| week
language	string	pt-BR	Idioma
page	number	1	Página
field	string	—	Filtra campo dos resultados

          /api/v1/trending                         ← tudo esta semana
          /api/v1/trending?media=movie&window=day  ← filmes hoje
          /api/v1/trending?media=tv&field=name     ← só nomes das séries
        

GET /api/v1/discover Filtros avançados ⌄

Todos os filtros do endpoint /discover do TMDB em um só lugar.

Param	Tipo	Default	Descrição
media	string	movie	movie \| tv
sort_by	string	popularity.desc	popularity \| vote_average \| release_date + .desc/.asc
genre	string	—	ID(s) de género. Ex: 28,12 (AND) ou 28\|12 (OR)
year	number	—	Ano exato de lançamento
year_gte / year_lte	number	—	Intervalo de anos
vote_gte	number	—	Nota mínima (ex: 7)
votes_gte	number	—	Mínimo de votos (filtra obscuros)
runtime_gte / runtime_lte	number	—	Duração em minutos
keyword	string	—	Keyword ID do TMDB (ex: 210024 = anime)
with_networks	string	—	ID de rede TV (Netflix=213, Prime=1024...)
page	number	1	Página

          /api/v1/discover?media=movie&genre=28&year_gte=2020&vote_gte=7
          /api/v1/discover?media=tv&with_networks=213&sort_by=vote_average.desc
          /api/v1/discover?media=movie&runtime_lte=90   ← filmes curtos
          /api/v1/discover?media=movie&year=1994&sort_by=vote_average.desc
        

GET /api/v1/genres Lista de géneros ⌄

Param	Tipo	Default	Descrição
media	string	both	movie \| tv \| both (merge deduplicado)
language	string	pt-BR	Idioma dos nomes

          /api/v1/genres
          /api/v1/genres?media=movie&language=en-US
        

GET /api/v1/nowplaying Filmes em cartaz ⌄

language · region · page · field

          /api/v1/nowplaying
          /api/v1/nowplaying?region=US&language=en-US
          /api/v1/nowplaying?field=title   ← só títulos
        

GET /api/v1/toprated Mais bem avaliados ⌄

media (movie|tv) · language · region · page · field

          /api/v1/toprated?media=tv
          /api/v1/toprated?media=movie&language=en-US
        

GET /api/v1/anime Animes em alta ⌄

Usa keyword 210024 + genre 16 (Animation) — mesma lógica do CYNEBLACK.

Param	Tipo	Default	Descrição
language	string	pt-BR	Idioma
page	number	1	Página
sort_by	string	popularity.desc	Ordenação
include_movies	bool	false	Inclui filmes anime também
field	string	—	Filtra campo

          /api/v1/anime
          /api/v1/anime?include_movies=true&sort_by=vote_average.desc
        

GET /api/v1/embed/[tmdb_id] URL de embed ⌄

Gera URL de embed para qualquer servidor. Resolve o IMDB ID automaticamente quando necessário.

Param	Tipo	Default	Descrição
type	string	movie	movie \| tv
server	string	multiembed	vidsrc \| warezcdn \| gstream \| multiembed \| playerflix \| superflix
season	number	1	Temporada (TV)
episode	number	1	Episódio (TV)
lang	string	pt	Idioma 2 letras
imdb	string	—	IMDB ID manual (opcional)
all	bool	false	Retorna todos os servidores de uma vez

          /api/v1/embed/550?server=vidsrc&type=movie
          /api/v1/embed/1396?server=warezcdn&type=tv&season=2&episode=1
          /api/v1/embed/37854?server=gstream&type=tv   ← One Piece
          /api/v1/embed/550?all=true                   ← todos os 9 servidores
        

GET /api/v1/servers Lista de servidores ⌄

Retorna todos os 9 servidores de streaming com metadados: se precisam de IMDB ID, suporte a filme/TV/anime, URL base.

Casos de uso

Exemplos Práticos

Search Buscar filmes de 2024 bem avaliados

GET cyne-api.vercel.app /api/v1/search ?q=2024&type=movie&sort_by=vote_average.desc

Retorna filmes de 2024 ordenados por nota.

ID Só o poster de um filme

GET cyne-api.vercel.app /api/v1/id/550 ?field=poster_path

Retorna { "poster_path": "/bptfVGEQuv6vDTIMVCHjJ9Dz8PX.jpg" }

ID Ficha completa com créditos e ratings

GET cyne-api.vercel.app /api/v1/id/tt0137523 ?append=credits,videos&omdb=true

Fight Club via IMDB ID — retorna elenco, trailers + IMDb rating e Rotten Tomatoes.

Embed URL de player para série

GET cyne-api.vercel.app /api/v1/embed/1396 ?type=tv&server=warezcdn&season=3&episode=7

Breaking Bad S03E07 no WarezCdn. Retorna o embed_url pronto para usar num iframe.

Embed Todos os servidores de uma vez

GET cyne-api.vercel.app /api/v1/embed/550 ?all=true

Retorna as 9 URLs de embed de uma vez. Ideal para mostrar opções ao utilizador.

Discover Filmes de ação pós-2020 nota ≥ 7

GET cyne-api.vercel.app /api/v1/discover ?media=movie&genre=28&year_gte=2020&vote_gte=7&votes_gte=1000

Filtro completo: género Ação (28), a partir de 2020, nota mínima 7, com pelo menos 1000 votos.

Discover Séries originais Netflix

GET cyne-api.vercel.app /api/v1/discover ?media=tv&with_networks=213&sort_by=vote_average.desc

Séries da Netflix (ID 213) ordenadas por nota. Troca por 1024 para Prime, 2739 para Disney+.

Anime Animes mais bem avaliados

GET cyne-api.vercel.app /api/v1/anime ?sort_by=vote_average.desc&include_movies=true

Inclui filmes anime também (ex: Studio Ghibli). Ordenado por nota.

Só os posters do trending de hoje

GET cyne-api.vercel.app /api/v1/trending ?window=day&media=movie&field=poster_path

Retorna só os poster_path dos filmes trending hoje. Útil para carousels leves.

Discover Filmes curtos de 1994 (os clássicos)

GET cyne-api.vercel.app /api/v1/discover ?media=movie&year=1994&sort_by=vote_average.desc&runtime_lte=120

1994 foi um ano lendário (Pulp Fiction, Forrest Gump, Shawshank...). Filmes até 120 min, ordenados por nota.

Search Busca por pessoa

GET cyne-api.vercel.app /api/v1/search ?q=Christopher Nolan&type=person

Retorna perfil do diretor com seus filmes conhecidos no campo known_for.

ID Título + poster + nota em 1 request

GET cyne-api.vercel.app /api/v1/id/238 ?fields=title,poster_path,vote_average,release_date

O Padrinho — só os campos que precisas, sem overhead.