Documentação da API

Guia completo para integrar a Alauda API no seu projeto.

Base URL: https://alauda-api.topazioverse.com.br

🔐 Autenticação

Todas as requisições (exceto /info) requerem uma API Key no header:

bash
curl -X POST https://alauda-api.topazioverse.com.br/api/tiktok/download \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.tiktok.com/@user/video/123"}'

⚠️ Importante: Nunca exponha sua API Key publicamente. Use variáveis de ambiente em produção.

💰 Sistema de Créditos

Cada requisição consome créditos da sua conta:

TikTok Download1 crédito
Instagram Download1 crédito
YouTube Download2 créditos
Spotify Download1 crédito
Remove Background3 créditos

💡 10.000 requests = 100 MT (R$ 10)

📡 Endpoints Disponíveis

POST/api/tiktok/download

TikTok Downloader

Baixa vídeos do TikTok sem marca d'água

Request

json
{
  "url": "https://www.tiktok.com/@user/video/7123456789"
}

Response

json
{
  "success": true,
  "video": {
    "id": "7123456789",
    "title": "Título do vídeo",
    "cover": "https://...",
    "duration": 15,
    "download": {
      "no_watermark": "https://...",
      "watermark": "https://...",
      "hd": "https://..."
    },
    "audio": "https://...",
    "stats": {
      "plays": 1500000,
      "likes": 95000,
      "comments": 1200,
      "shares": 850
    },
    "author": {
      "username": "user",
      "nickname": "Nome do Usuário",
      "avatar": "https://..."
    }
  },
  "credits_remaining": 9999
}
POST/api/instagram/download

Instagram Downloader

Baixa fotos, vídeos e reels do Instagram

Request

json
{
  "url": "https://www.instagram.com/p/ABC123/"
}

Response

json
{
  "success": true,
  "media": {
    "type": "video",
    "url": "https://...",
    "thumbnail": "https://...",
    "caption": "Legenda do post",
    "likes": 5420,
    "comments": 128
  },
  "credits_remaining": 9998
}
POST/api/youtube/download

YouTube Downloader

Baixa vídeos e áudio do YouTube

Request

json
{
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

Response

json
{
  "success": true,
  "video": {
    "title": "Título do vídeo",
    "duration": "3:32",
    "formats": {
      "video_hd": "https://...",
      "video_sd": "https://...",
      "audio": "https://..."
    },
    "thumbnail": "https://...",
    "views": 1500000000
  },
  "credits_remaining": 9996
}
POST/api/spotify/download

Spotify Downloader

Baixa músicas e informações do Spotify

Request

json
{
  "url": "https://open.spotify.com/track/..."
}

Response

json
{
  "success": true,
  "track": {
    "name": "Nome da Música",
    "artist": "Artista",
    "album": "Álbum",
    "duration": "3:45",
    "preview_url": "https://...",
    "download_url": "https://..."
  },
  "credits_remaining": 9995
}

📊 Info Only

Use /info-only para obter apenas as informações sem os links de download (consome menos créditos).

bash
POST /api/tiktok/info-only
POST /api/instagram/info-only
POST /api/youtube/info-only

🚀 Batch Download (PRO/PREMIUM)

Baixe múltiplos vídeos de uma vez (máximo 10 por requisição).

json
{
  "urls": [
    "https://www.tiktok.com/@user/video/1",
    "https://www.tiktok.com/@user/video/2",
    "https://www.tiktok.com/@user/video/3"
  ]
}

⚠️ Códigos de Erro

400Bad Request - Parâmetros inválidos
401Unauthorized - API Key inválida ou ausente
402Payment Required - Créditos insuficientes
403Forbidden - Recurso não disponível no seu plano
404Not Found - Endpoint não existe
429Too Many Requests - Rate limit excedido
500Internal Server Error - Erro no servidor
503Service Unavailable - Serviço temporariamente indisponível

💻 Exemplos de Código

JavaScript/Node.js

javascript
const axios = require('axios');

const response = await axios.post(
  'https://alauda-api.topazioverse.com.br/api/tiktok/download',
  { url: 'https://www.tiktok.com/@user/video/123' },
  {
    headers: {
      'X-API-Key': process.env.ALAUDA_API_KEY,
      'Content-Type': 'application/json'
    }
  }
);

console.log(response.data.video.download.no_watermark);

Python

python
import requests

response = requests.post(
    'https://alauda-api.topazioverse.com.br/api/tiktok/download',
    json={'url': 'https://www.tiktok.com/@user/video/123'},
    headers={
        'X-API-Key': 'sua_api_key_aqui',
        'Content-Type': 'application/json'
    }
)

data = response.json()
print(data['video']['download']['no_watermark'])

PHP

php
<?php
$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://alauda-api.topazioverse.com.br/api/tiktok/download',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode(['url' => 'https://www.tiktok.com/@user/video/123']),
    CURLOPT_HTTPHEADER => [
        'X-API-Key: sua_api_key_aqui',
        'Content-Type: application/json'
    ]
]);

$response = curl_exec($curl);
$data = json_decode($response, true);

echo $data['video']['download']['no_watermark'];
curl_close($curl);

Precisa de ajuda?

Entre em contato via WhatsApp ou email para suporte técnico.

WhatsApp: +258 86 284 0075Email: mozhost@topazioverse.com.br