TwitterDown API v1

Vue d'ensemble

TwitterDown API donne aux développeurs un accès programmatique à l'extraction vidéo Twitter/X pour l'automatisation, l'archivage média, les workflows de contenu et les outils internes.

• Base URL : https://twitterdown.com/api/v1
• Authentification : Bearer token (clé API)
• Format de réponse : application/json

Authentification

Chaque requête doit inclure une clé API valide dans l'en-tête Authorization. Les clés sont liées à votre compte et peuvent être révoquées à tout moment depuis le tableau de bord.

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

Clé API

1. Connectez-vous à TwitterDown et activez une offre avec accès API.
2. Ouvrez Dashboard > API Keys.
3. Créez une clé avec un libellé correspondant à votre application ou environnement.

La clé API n'est affichée qu'une seule fois. Enregistrez-la dans un gestionnaire de secrets avant de quitter la page.

Endpoints principaux

POST /twitter

POST /twitter résout une URL publique de tweet et renvoie miniature, variantes vidéo, texte, nom d'utilisateur et identifiant du statut.

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

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

Réponse réussie (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

Retourne les métadonnées de l'endpoint pour les intégrations, l'amorçage SDK ou les vérifications opérationnelles.

Limites de débit

• 60 requêtes / minute
• 1 000 requêtes / heure
• 10 000 requêtes / jour

Lisez X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset à chaque réponse. En cas de dépassement, l'API renvoie HTTP 429 avec Retry-After.

Gestion des erreurs

Toutes les erreurs renvoient du JSON avec un code numérique et un message lisible.

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

Exemples

Utilisez les exemples ci-dessous comme point de départ pour vos intégrations backend, scripts d'automatisation ou outils internes.

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())

Besoin de plus d'idées d'implémentation ? Consultez les guides API du blog pour voir des modèles d'intégration, notes de version et exemples de workflow.