Referência da API

A API do TikDeck permite extrair metadados e links diretos (sem marca d'água) de vídeos do TikTok, Instagram Reels e YouTube Shorts. Use as rotas abaixo para integrar o extrator no seu próprio sistema.

Autenticação

Para proteger o servidor contra abusos, a API pública requer uma API Key em todas as requisições (com exceção das requisições originadas do próprio painel web interno).

Você deve enviar a chave no cabeçalho HTTP X-API-Key.

Authorization: 
X-API-Key: td_8f72a1b9c3...
    

Rate Limits

Para garantir estabilidade, aplicamos os seguintes limites de taxa (baseados no IP e API Key):

/api/info: 30 requisições por minuto.
/api/bulk: 5 requisições por minuto.

Endpoints

Análise de Vídeo Único

POST /api/info

Retorna os metadados do vídeo e as URLs diretas de download. Você deve enviar o link num JSON.

curl -X POST http://127.0.0.1:5000/api/info \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_CHAVE_AQUI" \
  -d '{"url": "https://www.tiktok.com/@user/video/123"}'
    

Nota Multiplataforma: O TikDeck suporta vídeos do TikTok, Instagram e YouTube. Você pode enviar a URL de qualquer um deles da mesma forma:

curl -X POST http://127.0.0.1:5000/api/info \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_CHAVE_AQUI" \
  -d '{"url": "https://www.instagram.com/p/12345/"}'
    

Análise em Lote (Bulk)

POST /api/bulk

Retorna os metadados de múltiplos vídeos de uma vez (limite de 10 URLs por requisição).

curl -X POST http://127.0.0.1:5000/api/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: SUA_CHAVE_AQUI" \
  -d '{"urls": ["https://tiktok.com/.../123", "https://youtube.com/shorts/..."]}'
    

Download via Proxy

GET /api/download/<token>/<kind>

As rotas /api/info e /api/bulk retornam um token para o vídeo. Use esse token para fazer o download do arquivo sem CORS (Cross-Origin) e com cabeçalhos corretos de Content-Disposition (para forçar o navegador a baixar e não apenas abrir o vídeo).
O kind pode ser: normal, hd, watermark, audio, zip ou mp4.

curl -O -J http://127.0.0.1:5000/api/download/SEU_TOKEN_AQUI/normal

Códigos de Erro

Status	Significado	Descrição
`400`	Bad Request	A URL enviada é inválida ou falta o corpo do JSON.
`401`	Unauthorized	A `X-API-Key` não foi enviada ou é inválida.
`403`	Forbidden	A sua API Key foi revogada pelo administrador.
`404`	Not Found	Vídeo privado ou apagado na plataforma original.
`429`	Too Many Requests	Você estourou o Rate Limit. Aguarde um minuto.