Documentación API

Bienvenido a la API de TorrentControl

Esta es una API pública que proporciona acceso a nuestra base de datos de películas y series, incluyendo información de torrents. Puedes usar esta API para construir tus propias aplicaciones y servicios.

URL Base

https://torrentcontrol.pw/api/v1

Limitación de Tasa

60 peticiones por minuto por dirección IP. Por favor, usa la API responsablemente.

Política de Uso

Esta API se proporciona para uso público gratuito. Eres bienvenido a integrarla en tus aplicaciones y servicios. Sin embargo, ten en cuenta lo siguiente:

  • No abuses de la API con peticiones excesivas
  • Respeta los límites de tasa
  • No uses la API para propósitos ilegales
  • Nos reservamos el derecho de bloquear IPs que abusen del servicio

Ejemplo de endpoints disponibles

GET /api/v1/contents

Obtener una lista paginada de películas y series

Parámetros de Consulta
  • page - Número de página (por defecto: 1)
  • per_page - Elementos por página (por defecto: 20, máx: 100)
  • type - Filtrar por tipo: "movie" o "series"
  • search - Buscar por título
GET /api/v1/contents/{id}

Obtener información detallada sobre un contenido específico incluyendo todos los torrents

GET /api/v1/torrents

Get a flat list of torrents with content information (no nesting)

Parámetros de Consulta
  • page - Número de página (por defecto: 1)
  • per_page - Number of items per page (default: 20, max 20)
  • type - Filtrar por tipo: "movie" o "series"
  • search - Advanced search with multiple features:
    • SxxExx format: Search for specific episodes (e.g., S01E05, s02e10)
    • Combined search: Use series title with episode (e.g., Breaking S01E05)
    • AND logic: Multiple keywords require all words to match (e.g., Dark Knight)
    • File names: Also searches in torrent file names

Ejemplo de Petición

curl -X GET "https://torrentcontrol.pw/api/v1/contents?type=movie&per_page=10" \
  -H "Accept: application/json"

Especificación OpenAPI

Para la documentación completa de la API en formato OpenAPI:

Descargar Especificación OpenAPI
¿Necesitas ayuda? Si tienes preguntas o encuentras problemas con la API, no dudes en contactarnos a través de nuestros canales de soporte.