XVideos 🔞

Busca e download de vídeos adultos

Buscar Vídeos

POST/api/xvideos/search

Busca vídeos no XVideos com filtros de ordenação, data e duração.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
query	string	Sim	Termo de busca
page	number	Não	Página de resultados (padrão: 1)
sort	string	Não	Ordenação: views, rating, date
date	string	Não	Filtro de data: today, week, month, 3month, 6month, year, all
duration	string	Não	Filtro de duração: 1-3min, 3-10min, 10-20min, 20min_more

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/xvideos/search \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "amateur",
    "page": 1,
    "sort": "rating",
    "date": "month",
    "duration": "10-20min"
  }'

Resposta

json

{
  "success": true,
  "data": {
    "videos": [
      {
        "title": "Título do vídeo",
        "url": "https://www.xvideos.com/video12345/...",
        "thumbnail": "https://img-hw.xvideos-cdn.com/...",
        "duration": "15:30",
        "views": 125000,
        "rating": "94%"
      }
    ],
    "page": 1,
    "total_results": 50,
    "credits_remaining": 4490
  }
}

Custo: 10 créditos por busca

Download de Vídeo

POST/api/xvideos/download

Faz o download de um vídeo a partir da URL.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
url	string	Sim	URL do vídeo no XVideos

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/xvideos/download \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.xvideos.com/video12345/titulo-do-video"
  }'

JavaScript (fetch)

javascript

const response = await fetch('https://api.alauda.mz/api/xvideos/download', {
  method: 'POST',
  headers: {
    'X-API-Key': 'sua_api_key_aqui',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://www.xvideos.com/video12345/titulo-do-video'
  })
});

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

Resposta

json

{
  "success": true,
  "message": "Download realizado com sucesso",
  "data": {
    "download_url": "https://storage.alauda.mz/downloads/xvideos/abc123.mp4",
    "title": "Título do vídeo",
    "duration": "15:30",
    "quality": "720p",
    "size": "85.2 MB",
    "credits_remaining": 4440
  }
}

Custo: 50 créditos por download

Busca + Download Automático

POST/api/xvideos/auto

Busca um vídeo e faz o download automaticamente do primeiro resultado.

Body (JSON)

Campo	Tipo	Obrigatório	Descrição
query	string	Sim	Termo de busca

Exemplo de Requisição

bash

curl -X POST https://api.alauda.mz/api/xvideos/auto \
  -H "X-API-Key: sua_api_key_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "amateur"
  }'

Resposta

json

{
  "success": true,
  "message": "Busca e download realizados com sucesso",
  "data": {
    "download_url": "https://storage.alauda.mz/downloads/xvideos/def456.mp4",
    "title": "Título do vídeo encontrado",
    "duration": "12:45",
    "quality": "720p",
    "size": "72.1 MB",
    "credits_remaining": 4340
  }
}

Custo: 100 créditos por operação (busca + download combinados)

Opções de Filtros

Ordenação (sort)

views- Mais visualizados
rating- Melhor avaliados
date- Mais recentes

Data (date)

today- Hoje
week- Esta semana
month- Este mês
3month- 3 meses
6month- 6 meses
year- Este ano
all- Todos

Duração (duration)

1-3min- 1 a 3 minutos
3-10min- 3 a 10 minutos
10-20min- 10 a 20 minutos
20min_more- Mais de 20 minutos

🔞

Conteúdo Adulto

Este endpoint contém conteúdo adulto e é restrito a maiores de 18 anos. Ao utilizar esta API, você confirma ter idade legal.

⚠️

Acesso Restrito

Este endpoint está disponível apenas para usuários com planos PRO e PREMIUM. Usuários do plano gratuito não têm acesso a esta funcionalidade.

💡

Dica

Use a rota /auto para uma experiência simplificada. Para mais controle sobre os resultados, use /search seguido de /download.