Documentação da API PornyVideos

API pública para acesso a conteúdo adulto de alta qualidade

Introdução

A API PornyVideos permite que desenvolvedores acessem nossa vasta coleção de vídeos adultos para integração em seus próprios aplicativos e sites.

URL Base: https://www.pornyvideos.online/api

Todos os endpoints retornam dados no formato JSON e suportam CORS para uso em aplicações web.

Limites de Uso

Para garantir a disponibilidade do serviço para todos os usuários, aplicamos os seguintes limites:

  • Máximo de 10 requisições por minuto por endereço IP para endpoints de listagem e detalhes
  • Máximo de 5 requisições por minuto por endereço IP para o endpoint de vídeos removidos
  • Máximo de 1000 itens por página em listagens

Exceder esses limites resultará em respostas com código de status 429 Too Many Requests.

Endpoints

GET

/api/videos

Retorna uma lista paginada de vídeos.

Parâmetros de Query

ParâmetroTipoPadrãoDescrição
pageNúmero1Número da página
per_pageNúmero30Itens por página (máx. 1000)
queryString"all"Termo de busca (use "all" para todos os vídeos)
orderString"latest"Ordenação: "latest" (mais recentes), "longest" (mais longos), "shortest" (mais curtos), "top-rated" (melhor avaliados), "most-popular" (mais populares), "top-weekly" (mais populares da semana), "top-monthly" (mais populares do mês)
thumbsizeString"big"Tamanho das miniaturas: "small" (190x152), "medium" (427x240), "big" (640x360)
gayNúmero0Conteúdo gay: 0 (excluir), 1 (incluir), 2 (apenas gay)
lqNúmero1Conteúdo de baixa qualidade: 0 (excluir), 1 (incluir), 2 (apenas baixa qualidade)

Exemplo de Resposta

{
  "count": 30,
  "page": 1,
  "per_page": 30,
  "total_pages": 4116,
  "videos": [
    {
      "id": "abc123",
      "title": "Título do vídeo",
      "url": "https://www.eporner.com/video-abc123/",
      "views": 12345,
      "rate": 4.5,
      "added": "2023-01-15T12:30:45Z",
      "length_sec": 720,
      "length_min": "12:00",
      "embed": "<iframe src=\"...\"></iframe>",
      "default_thumb": {
        "size": "big",
        "width": 640,
        "height": 360,
        "src": "https://example.com/thumb.jpg"
      },
      "thumbs": [
        {
          "size": "big",
          "width": 640,
          "height": 360,
          "src": "https://example.com/thumb1.jpg"
        }
      ]
    }
    // ... mais vídeos
  ]
}

Exemplo de Uso

fetch('https://www.pornyvideos.online/api/videos?page=1&per_page=10&query=blonde&order=most-popular') .then(response => response.json()) .then(data => console.log(data));
GET

/api/videos/{id}

Retorna detalhes de um vídeo específico pelo ID.

Parâmetros de Path

ParâmetroTipoDescrição
idStringID único do vídeo

Parâmetros de Query

ParâmetroTipoPadrãoDescrição
thumbsizeString"big"Tamanho das miniaturas: "small" (190x152), "medium" (427x240), "big" (640x360)

Exemplo de Resposta

{
  "id": "abc123",
  "title": "Título do vídeo",
  "url": "https://www.eporner.com/video-abc123/",
  "views": 12345,
  "rate": 4.5,
  "added": "2023-01-15T12:30:45Z",
  "length_sec": 720,
  "length_min": "12:00",
  "embed": "<iframe src=\"...\"></iframe>",
  "keywords": "tag1,tag2,tag3",
  "default_thumb": {
    "size": "big",
    "width": 640,
    "height": 360,
    "src": "https://example.com/thumb.jpg"
  },
  "thumbs": [
    {
      "size": "big",
      "width": 640,
      "height": 360,
      "src": "https://example.com/thumb1.jpg"
    }
    // ... mais miniaturas
  ]
}

Exemplo de Uso

fetch('https://www.pornyvideos.online/api/videos/abc123') .then(response => response.json()) .then(data => console.log(data));
GET

/api/videos/removed

Retorna uma lista de IDs de vídeos que foram removidos da plataforma.

Atenção: Este endpoint retorna uma grande quantidade de dados (vários megabytes). Use com moderação e implemente cache adequado em sua aplicação.

Exemplo de Resposta

{
  "removed_ids": [
    "abc123",
    "def456",
    "ghi789",
    // ... muitos mais IDs
  ]
}

Exemplo de Uso

fetch('https://www.pornyvideos.online/api/videos/removed') .then(response => response.json()) .then(data => console.log(data));

Códigos de Status

CódigoDescrição
200 OKA requisição foi bem-sucedida
400 Bad RequestParâmetros inválidos ou ausentes
404 Not FoundRecurso não encontrado
429 Too Many RequestsLimite de requisições excedido
500 Internal Server ErrorErro interno do servidor

Termos de Uso

Ao utilizar nossa API, você concorda com os seguintes termos:

  • O conteúdo acessado através da API é destinado apenas para adultos (18+)
  • Você é responsável por implementar verificação de idade em seu aplicativo/site
  • Não é permitido armazenar ou fazer cache do conteúdo por mais de 24 horas
  • Você deve atribuir a fonte do conteúdo ao PornyVideos com um link para nosso site
  • Não é permitido usar a API para fins ilegais ou que violem nossos termos de serviço
  • Reservamo-nos o direito de limitar ou revogar o acesso à API a qualquer momento

Contato e Suporte

Para dúvidas, suporte ou relatar problemas com a API, entre em contato conosco: