Documentación de API

App.apiDescription

Primeros Pasos

Para usar la API de YTMP3CV.COM, necesitarás una clave de API. Si aún no tienes una, contáctanos para comenzar.

Todas las solicitudes de API deben realizarse a la siguiente URL base:

https://api.ytmp3cv.com/

Autenticación

Incluye tu clave de API en el encabezado de todas las solicitudes:

Authorization: Bearer TU_CLAVE_API

Endpoints

Convertir YouTube a MP3

POST /convert

Convierte un video de YouTube a formato MP3.

Parámetros

Nombre Tipo Descripción
url string La URL del video de YouTube
quality string Opcional. Calidad de audio (alta, media, baja). Por defecto: alta

Ejemplo de Solicitud


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

data = {
    'url': 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
    'quality': 'high'
}

response = requests.post('https://api.ytmp3cv.com/convert', headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    print(f"Download URL: {result['download_url']}")
else:
    print(f"Error: {response.status_code}")

Obtener Estado de Conversión

GET /status/{conversion_id}

Verifica el estado de un trabajo de conversión.

Parámetros

Nombre Tipo Descripción
conversion_id string El ID del trabajo de conversión

Ejemplo de Solicitud


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}'
}

conversion_id = 'abc123'
response = requests.get(f'https://api.ytmp3cv.com/status/{conversion_id}', headers=headers)

if response.status_code == 200:
    result = response.json()
    print(f"Status: {result['status']}")
    print(f"Progress: {result['progress']}%")
else:
    print(f"Error: {response.status_code}")

Conversión por Lotes

POST /batch-convert

Convierte múltiples videos de YouTube a formato MP3 en una sola solicitud.

Parámetros

Nombre Tipo Descripción
urls array Un array de URLs de videos de YouTube
quality string Opcional. Calidad de audio (alta, media, baja). Por defecto: alta

Ejemplo de Solicitud


import requests

api_key = 'YOUR_API_KEY'
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

data = {
    'urls': [
        'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
        'https://www.youtube.com/watch?v=9bZkp7q19f0'
    ],
    'quality': 'high'
}

response = requests.post('https://api.ytmp3cv.com/batch-convert', headers=headers, json=data)

if response.status_code == 200:
    result = response.json()
    for job in result['jobs']:
        print(f"Conversion ID: {job['conversion_id']}")
else:
    print(f"Error: {response.status_code}")

Límite de Tasa

Para garantizar un uso justo y mantener la calidad del servicio, nuestra API implementa límites de tasa. Los límites actuales son:

Marco de Tiempo Límite de Solicitudes
Por Minuto 100 requests
Por Hora 1,000 requests
Por Día 10,000 requests

Si excedes estos límites, recibirás una respuesta 429 Demasiadas Solicitudes. La respuesta incluirá los siguientes encabezados:

  • X-RateLimit-Limit: El límite máximo de tasa para esa solicitud dada
  • X-RateLimit-Remaining: El número de solicitudes restantes para la ventana de tiempo
  • X-RateLimit-Reset: La ventana restante antes de que se restablezca el límite de tasa en segundos de época UTC

Para límites de tasa más altos adaptados a tu caso de uso específico, por favor contacta a nuestro equipo de ventas.

Manejo de Errores

Descripción

Código Descripción
200 OK La solicitud fue exitosa.
400 Bad Request La solicitud no es válida o no se puede atender. El error exacto se explica en el mensaje de error.
401 Unauthorized La solicitud requiere autenticación del usuario.
403 Forbidden El servidor entendió la solicitud pero se niega a autorizarla.
404 Not Found No se pudo encontrar el recurso solicitado.
429 Too Many Requests Has enviado demasiadas solicitudes en un período de tiempo determinado.
500 Internal Server Error Tuvimos un problema con nuestro servidor. Inténtalo de nuevo más tarde.

Todas las respuestas de error incluirán un objeto JSON en el cuerpo de la respuesta con la siguiente estructura:


{
    "error": {
        "code": "ERROR_CODE",
        "message": "A human-readable error message"
    }
}

Recomendamos implementar un manejo de errores adecuado en tu aplicación para gestionar estos escenarios con elegancia y proporcionar una experiencia de usuario fluida.

Comienza con Nuestra API

¿Listo para integrar nuestra poderosa conversión de YouTube a MP3 en tu aplicación?

Contactar Ventas