TwitterDown API v1

Resumen

TwitterDown API ofrece a los desarrolladores acceso programático a la extracción de vídeo de Twitter/X para automatización, archivado, flujos de contenido y herramientas internas.

• Base URL: https://twitterdown.com/api/v1
• Autenticación: Bearer token (API key)
• Formato de respuesta: application/json

Autenticación

Cada solicitud debe incluir una API key válida en la cabecera Authorization. Las claves están ligadas a tu cuenta y pueden revocarse en cualquier momento desde el panel.

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

API Key

1. Inicia sesión en TwitterDown y activa un plan con acceso API.
2. Abre Dashboard > API Keys.
3. Crea una clave con una etiqueta que identifique tu app o entorno.

La API key solo se muestra una vez. Guárdala en un gestor de secretos antes de salir de la página.

Endpoints principales

POST /twitter

POST /twitter resuelve una URL pública de tweet y devuelve miniatura, variantes de vídeo, texto, nombre de usuario e identificador del estado.

POST https://twitterdown.com/api/v1/twitter
Content-Type: application/json
Authorization: Bearer sk-xxxx

{
  "url": "https://x.com/username/status/1234567890123456789"
}

Respuesta correcta (200):

{
  "code": 0,
  "message": "ok",
  "data": {
    "thumbnail": "https://pbs.twimg.com/...jpg",
    "videos": [
      { "resolution": "720p", "quality": "HD", "url": "https://video.twimg.com/..." },
      { "resolution": "360p", "quality": "SD", "url": "https://video.twimg.com/..." }
    ],
    "text": "Tweet text",
    "username": "username",
    "statusId": "1234567890123456789",
    "processed_at": "2024-01-01T12:00:00.000Z"
  }
}

GET /twitter

Devuelve metadatos del endpoint para integraciones, inicialización de SDK o comprobaciones operativas.

Límites de uso

• 60 solicitudes / minuto
• 1.000 solicitudes / hora
• 10.000 solicitudes / día

Lee X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en cada respuesta. Si superas la cuota, la API devuelve HTTP 429 con Retry-After.

Gestión de errores

Todos los errores devuelven JSON con un código numérico y un mensaje legible.

{
  "code": -1,
  "message": "Readable error message"
}

Ejemplos

Usa los siguientes ejemplos como punto de partida para integraciones backend, scripts de automatización o herramientas internas.

const res = await fetch("https://twitterdown.com/api/v1/twitter", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-xxxx"
  },
  body: JSON.stringify({ url })
});
const data = await res.json();

resp = requests.post(
  "https://twitterdown.com/api/v1/twitter",
  headers={
    "Authorization": "Bearer sk-xxxx",
    "Content-Type": "application/json",
  },
  json={"url": tweet_url},
)
print(resp.json())

¿Necesitas más ideas de implementación? Explora las guías API del blog para ver patrones de integración, notas de lanzamiento y ejemplos de flujo.