TwitterDown API v1

Überblick

Die TwitterDown API bietet Entwicklern programmatischen Zugriff auf die Twitter/X-Videoextraktion für Automatisierung, Medienarchivierung, Content-Workflows und interne Tools.

• Base URL: https://twitterdown.com/api/v1
• Authentifizierung: Bearer Token (API-Key)
• Antwortformat: application/json

Authentifizierung

Jede Anfrage muss einen gültigen API-Key im Authorization-Header enthalten. Schlüssel sind an dein Konto gebunden und können jederzeit im Dashboard widerrufen werden.

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

API-Key

1. Melde dich bei TwitterDown an und aktiviere einen Plan mit API-Zugang.
2. Öffne Dashboard > API Keys.
3. Erstelle einen Schlüssel mit einem Label für App oder Umgebung.

Der API-Key wird nur einmal angezeigt. Speichere ihn vor dem Verlassen in einem Secret-Manager.

Kern-Endpunkte

POST /twitter

POST /twitter verarbeitet eine öffentliche Tweet-URL und liefert Vorschaubild, Video-Varianten, Text, Benutzername und Status-ID zurück.

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

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

Erfolgreiche Antwort (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

Liefert Endpunkt-Metadaten für Integrationen, SDK-Initialisierung oder Betriebsprüfungen.

Rate Limits

• 60 Anfragen / Minute
• 1.000 Anfragen / Stunde
• 10.000 Anfragen / Tag

Lies X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset bei jeder Antwort. Bei Überschreitung gibt die API HTTP 429 mit Retry-After zurück.

Fehlerbehandlung

Alle Fehler geben JSON mit einem numerischen Code und einer lesbaren Meldung zurück.

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

Beispiele

Nutze die folgenden Snippets als Ausgangspunkt für Backend-Integrationen, Automatisierungsskripte oder interne Entwickler-Tools.

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

Mehr Implementierungsbeispiele gesucht? Öffne die API-Guides im Blog für Integrationsmuster, Release-Notizen und Workflow-Beispiele.