Facebook 📘

Download de vídeos e reels do Facebook

Download de Vídeo

POST/api/facebook/download

Faz download de um vídeo ou reel do Facebook em qualidade HD e SD.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
url	string	Sim	URL do vídeo ou reel do Facebook

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/facebook/download \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.facebook.com/watch/?v=123456789"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/facebook/download', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://www.facebook.com/watch/?v=123456789'
  })
});

const data = await response.json();
console.log(data.data.download_url_hd);

Resposta

json

{
  "success": true,
  "message": "Download realizado com sucesso",
  "data": {
    "download_url_hd": "https://storage.alauda.mz/downloads/facebook/abc123_hd.mp4",
    "download_url_sd": "https://storage.alauda.mz/downloads/facebook/abc123_sd.mp4",
    "title": "Vídeo do Facebook",
    "duration": "2:45",
    "thumbnail": "https://storage.alauda.mz/thumbnails/facebook/abc123.jpg",
    "has_audio": true,
    "credits_remaining": 4999
  }
}

Custo: 1 crédito por requisição

Apenas Informações

POST/api/facebook/info-only

Retorna apenas as informações do vídeo sem fazer download.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
url	string	Sim	URL do vídeo ou reel do Facebook

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/facebook/info-only \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.facebook.com/reel/123456789"
  }'

Resposta

json

{
  "success": true,
  "data": {
    "title": "Reel do Facebook",
    "duration": "0:30",
    "thumbnail": "https://storage.alauda.mz/thumbnails/facebook/abc123.jpg",
    "has_audio": true,
    "quality_available": ["HD", "SD"]
  }
}

Custo: 1 crédito por requisição

Download em Lote

POST/api/facebook/batch

Faz download de múltiplos vídeos de uma vez. Máximo de 10 URLs por requisição.

🔒 Apenas planos PRO e PREMIUM

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
urls	string[]	Sim	Array de URLs (máx. 10)

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/facebook/batch \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.facebook.com/watch/?v=111111111",
      "https://www.facebook.com/reel/222222222",
      "https://fb.watch/abc123"
    ]
  }'

Resposta

json

{
  "success": true,
  "message": "Download em lote realizado com sucesso",
  "data": {
    "results": [
      {
        "url": "https://www.facebook.com/watch/?v=111111111",
        "download_url_hd": "https://storage.alauda.mz/downloads/facebook/vid1_hd.mp4",
        "download_url_sd": "https://storage.alauda.mz/downloads/facebook/vid1_sd.mp4",
        "title": "Vídeo 1",
        "status": "success"
      },
      {
        "url": "https://www.facebook.com/reel/222222222",
        "download_url_hd": "https://storage.alauda.mz/downloads/facebook/vid2_hd.mp4",
        "download_url_sd": "https://storage.alauda.mz/downloads/facebook/vid2_sd.mp4",
        "title": "Reel 2",
        "status": "success"
      }
    ],
    "total": 3,
    "successful": 3,
    "credits_remaining": 4997
  }
}

Custo: 1 crédito por URL no lote

URLs Suportadas

✓
https://www.facebook.com/watch/?v=123...
Vídeos do Facebook Watch
✓
https://www.facebook.com/reel/123...
Reels do Facebook
✓
https://www.facebook.com/share/v/ABC123/
Links de compartilhamento
✓
https://fb.watch/ABC123/
Links curtos do Facebook

Recursos

✓
Qualidade HD e SD
Duas opções de qualidade em cada download
✓
Áudio Garantido
Todos os downloads incluem áudio
✓
Thumbnail
Imagem de capa do vídeo incluída na resposta

⚠️

Limitações

• Apenas vídeos públicos podem ser baixados
• Vídeos privados ou com restrições de privacidade não estão disponíveis
• O endpoint batch é exclusivo para planos PRO e PREMIUM

💡

Dica

Use a rota /info-only primeiro para verificar se o vídeo está disponível antes de fazer o download.