X (Twitter) API Tutorial 2026: OAuth, Stufen & Codebeispiele

The X API ist ein Toolkit für Entwickler, das ihnen ermöglicht, programmgesteuert auf öffentliche Daten und Funktionen von X zuzugreifen und mit ihnen zu interagieren. Es ist die Brücke, die es benutzerdefinierten Anwendungen erlaubt, Zeitlinien zu lesen, nach Beiträgen zu suchen und Inhalte zu veröffentlichen, ohne die offizielle X-App zu verwenden.

Was ist die X API und was kann sie tun?

Die X API bietet Ihrer Anwendung eine direkte Verbindung zur Plattform, sodass sie Daten lesen und Aktionen programmgesteuert auslösen kann. Das bedeutet, dass Sie Analyse-Dashboards, Content-Management-Systeme oder maßgeschneiderte Apps erstellen können, die in Echtzeit mit X kommunizieren.

Stell dir das wie einen Automaten vor: Du sendest eine Anfrage (Münze einwerfen), die API prüft deine Berechtigungen und liefert die Daten oder führt die Aktion aus. Dieses „Produkt“ könnte die letzten Beiträge eines Nutzers, Suchergebnisse oder die Möglichkeit sein, neue Inhalte zu veröffentlichen. Wenn du wissen möchtest, wie das im Vergleich zu anderen API-Typen aussieht, Eine Conversion-API ist eine Schnittstelle, die es Entwicklern ermöglicht, Daten über Nutzerinteraktionen und Conversions von einer Plattform zu einer anderen zu übertragen. Sie hilft dabei, das Nutzerverhalten besser zu verstehen und Marketingstrategien zu optimieren, indem sie präzise Informationen über die Wirksamkeit von Kampagnen liefert. Mit einer Conversion-API können Unternehmen ihre Marketingmaßnahmen gezielt anpassen und die Effizienz ihrer Werbeausgaben maximieren. bietet einen nützlichen Parallel aus der Marketingwelt.

Kernfunktionen

Die API ist in Zugriffsebenen unterteilt, die steuern, was Sie tun können und wie oft. Jede Ebene schaltet eine Reihe von "Endpunkten" frei – spezifische URLs, die Ihre App aufruft, um verschiedene Funktionen auszuführen.

Wenn Ihr Hauptinteresse im programmatischen Posten liegt, finden Sie in unserem Leitfaden zu Alternativen zur X Posting API deckt die besten Optionen ab.

X API Kernfunktionen auf einen Blick

Die richtige X API-Zugangsstufe wählen

Die Wahl eines Zugriffslevels ist eine der ersten Entscheidungen, die Sie treffen werden, und sie beeinflusst alles: was Sie erstellen können, wie viele Daten Sie abrufen können und was Sie bezahlen werden.

The Free Tier ist ideal, um eine schnelle Idee oder ein persönliches Projekt zu testen. Basic Tier eignet sich für kleinere Apps oder interne Tools, die nicht viele Daten benötigen. Pro Tier wurde für Startups und Unternehmen entwickelt, die große Datenmengen für Social Listening oder kommerzielle Analysen benötigen. Und die Enterprise Tier ist für großangelegte, mission-kritische Operationen mit individuellen Datenanforderungen gedacht.

Die verschiedenen Stufen verstehen

Der wichtigste Unterschied zwischen den Stufen ist Rate-Limits - wie viele Anfragen Sie in einem bestimmten Zeitraum stellen können. Erreichen Sie Ihr Limit in einer niedrigeren Stufe, wird Ihre App gestoppt. Für eine vollständige Übersicht über die Kosten werfen Sie einen Blick in unseren Leitfaden zu Twitter API Preisgestaltung.

Diese Infografik hilft, die zentrale Frage zu klären: Müssen Sie get Daten oder post Daten?

Vergleich der X API-Zugriffslevel

Der größte Sprung in der Funktionalität erfolgt zwischen Basic und Pro. Hier erhalten Sie erweiterte Suchendpunkte und deutlich höhere Ratenlimits – was eine Echtzeitanalyse von Daten tatsächlich möglich macht.

Beginne mit dem, was du jetzt brauchst, aber behalte die Grenzen im Hinterkopf, damit du weißt, wann es Zeit ist, ein Upgrade durchzuführen.

Einstieg in die API-Authentifizierung

Bevor Ihre App mit der X API interagieren kann, muss sie nachweisen, dass sie die erforderlichen Berechtigungen hat. Das ist die Authentifizierung – der digitale Handschlag, der Ihnen den Zugang ermöglicht.

Die X API verwendet zwei Standards: OAuth 1.0a and OAuth 2.0Die richtige Wahl hängt davon ab, was Ihre App tun soll.

Wählen Sie Ihren Authentifizierungsfluss aus

Frage dich: Handelt meine App eigenständig oder im Auftrag eines Nutzers?

• App-Only-Authentifizierung (OAuth 2.0 Bearer-Token): Nutze dies, wenn du einfach öffentliche Daten lesen möchtest – Trends durchsuchen, öffentliche Beiträge abrufen. Kein Benutzer-Login erforderlich.

• Benutzerauthentifizierung (OAuth 1.0a): Das benötigst du, wenn deine App aktiv wird. for ein Benutzer. Inhalte posten, Beiträge liken, Direktnachrichten senden. Der Benutzer muss Ihrer App ausdrücklich die Erlaubnis erteilen.

Die häufigste Falle für neue Entwickler ist der Versuch, die App-Only-Authentifizierung für Aktionen zu verwenden, die die Erlaubnis des Nutzers erfordern. Wenn du Inhalte posten möchtest, benötigst du OAuth 1.0a. Keine Ausnahmen.

API-Anmeldeinformationen erstellen

Gehe zu der X Entwicklerportal Um ein Projekt und eine App zu erstellen. Dort generierst du die Schlüssel und Tokens, die als Identität deiner App dienen.

Richten Sie ein Projekt ein, erstellen Sie eine App darin und holen Sie sich Ihre API-Schlüssel und Zugriffstoken. Behandeln Sie diese wie Passwörter. Stellen Sie sicher, dass sie nicht im Frontend-Code sichtbar sind oder in ein öffentliches Git-Repository eingegeben werden.

Arbeiten mit den wichtigsten API-Endpunkten

Die Authentifizierung ist erledigt. Jetzt kommt der nützliche Teil.

Ein Endpunkt ist einfach eine spezifische URL, an die deine App eine Anfrage sendet, wobei jeder Endpunkt für eine andere Aufgabe konzipiert ist. Benötigst du Informationen über einen Nutzer? Rufe den Endpunkt für Nutzer auf. Möchtest du Beiträge zu einem Thema? Nutze die Suche. Zu wissen, welchen Endpunkt du verwenden musst, ist die Grundlage für alles, was du aufbauen wirst.

Beiträge suchen

The GET /2/tweets/search/recent Der Endpoint ermöglicht es dir, nach Beiträgen der letzten sieben Tage zu suchen. Sende eine Abfrage mit deinem Schlüsselwort, und du erhältst ein JSON-Objekt mit den passenden Beiträgen – jeder Beitrag enthält die Post-ID, den Text, den Autor und die Engagement-Zahlen.

Benutzerdaten abrufen

The GET /2/users/by/username/:username Der Endpunkt ruft öffentliche Profildaten für jeden Benutzer ab. Sie erhalten zurück:

• Benutzer-ID: Die eindeutige numerische ID für dieses Konto.
• Profilinformationen: Anzeigename, Biografie, Standort und URL des Profilbildes.
• Öffentliche Kennzahlen: Follower-Zahl, Following-Zahl und Gesamtanzahl der Beiträge.

Diese Daten sind nützlich, um Benutzerprofile in deiner App zu erstellen oder Kontext zu den Beiträgen hinzuzufügen, die du analysierst.

Veröffentlichen und Verwalten von Beiträgen

The POST /2/tweets Der Endpoint kümmert sich um die Erstellung von Inhalten. Er funktioniert für Textbeiträge, Medienuploads, Umfragen und Antworten. Möchten Sie Ihre Content-Strategie automatisieren? Erfahren Sie, wie es geht. Beiträge auf X planen.

Hier ist eine einfache Anfrage zur Erstellung eines Beitrags:

curl --request POST \
  --url https://api.x.com/2/tweets \
  --header 'Authorization: Bearer ' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "Hallo, Welt! Dies ist mein erster Beitrag über die X API." }'

Die API antwortet mit einem JSON-Objekt, das die ID und den Text deines neuen Beitrags bestätigt.

Eine Sache, die viele Entwickler ins Stolpern bringt: Um Inhalte zu posten, musst du must Verwenden Sie eine Authentifizierungsmethode mit Benutzerkontext (OAuth 1.0a oder OAuth 2.0). Die App-Only-Authentifizierung funktioniert nicht, da sie keine Berechtigung hat, im Namen eines Benutzers zu handeln.

Dies ist eine Sicherheitsmaßnahme, kein Fehler. Sie stellt sicher, dass eine App nicht ohne Ihre ausdrückliche Genehmigung auf Ihr Konto posten kann.

Anwendungsbeispiele aus der Praxis

Soziale Medien Monitoring und Sentiment-Analyse

Unternehmen nutzen die Suchendpunkte, um Gespräche über ihre Marke, Produkte oder Wettbewerber in Echtzeit zu verfolgen. Ein Unternehmen, das ein Produkt launcht, kann sofort die Reaktionen der Kunden nachverfolgen, häufige Beschwerden erkennen und positives Feedback finden.

Die öffentliche Konversation auf X ist im Grunde genommen eine riesige, Echtzeit-Fokusgruppe. Darauf zuzugreifen, verschafft Marken datengestützte Einblicke in das, was ihre Zielgruppe tatsächlich sagt.

Automatisierung und Inhaltsverteilung

Automatisierung spart Stunden repetitiver Arbeit. Häufige Beispiele sind:

• Nachrichtensammler: Bots, die automatisch Artikel zu bestimmten Themen finden und teilen.
• Bots aktualisieren: Konten, die Echtzeitbenachrichtigungen senden - Wetter, Aktienkurse, neue Code-Commits von einem GitHub repo.
• Kundenservice-Trichter: Systeme, die Beiträge erkennen, die auf ein Kundenproblem hinweisen, und automatisch ein Support-Ticket erstellen in Zendesk or Intercom.

Marktforschung und Trendanalyse

Für Forscher und Analysten ist die X API eine direkte Verbindung zu einer einflussreichen Nutzerbasis. Fast 70 % der Mitglieder innerhalb der Altersgruppe 18-34 - eine Hauptzielgruppe für Marken, die sich auf Millennials und die Generation Z konzentrieren. Sie können tiefer eintauchen in Die Nutzer-Demografie von X bei Exploding Topics.

Von maßgeschneiderten Analyse-Dashboards bis hin zu Integrationen für digitale Beschilderung bietet die X API Entwicklern die Grundlage, um kontextbewusste Anwendungen zu erstellen, die echte Ergebnisse liefern.

Fehlerbehebung bei häufigen API-Fehlern

Jeder Entwickler, der mit der X API arbeitet, stößt auf Fehler. Betrachten Sie sie als Wegweiser, die Ihnen zeigen, was behoben werden muss, und nicht als Hindernisse. Die meisten Probleme erscheinen als standardmäßige HTTP-Statuscodes, und einige treten häufiger auf als andere.

Authentifizierungs- und Berechtigungsfehler

401 Nicht autorisiert Das bedeutet, dass ein Problem mit Ihren Anmeldeinformationen vorliegt. Ihre API-Schlüssel könnten falsch, abgelaufen oder im Anfrage-Header nicht korrekt formatiert sein. Überprüfen Sie, ob Sie das richtige Bearer-Token oder die OAuth-Signaturen senden. Die API sagt: "Ich weiß nicht, wer Sie sind."

403 Verboten ist subtiler. Ihre Anmeldeinformationen sind gültig – die API weiß, wer Sie sind – aber Sie haben nicht die richtigen Berechtigungen für die Aktion, die Sie versuchen auszuführen. Zum Beispiel könnten Sie versuchen, Inhalte mit einer App-Only-Authentifizierung zu posten. Das Problem liegt nicht an Ihren Schlüsseln. are, es ist das, was sie kann tun.

Umgang mit Rate-Limit-Fehlern

The 429 Zu viele Anfragen Ein Fehler bedeutet, dass Sie innerhalb des Zeitfensters zu viele Aufrufe an einen Endpunkt gemacht haben. X setzt diese Limits fest, um die Stabilität der Plattform für alle Nutzer zu gewährleisten.

Das sofortige Wiederholen bei einem 429-Fehler ist ein Fehler. Es führt zu einer Schleife fehlgeschlagener Anfragen und kann dazu führen, dass Ihre App vorübergehend blockiert wird.

Die API-Antwort für ein 429 enthält hilfreiche Überschriften:

• x-rate-limit-remainingWie viele Anfragen Ihnen im aktuellen Zeitfenster noch zur Verfügung stehen.
• x-rate-limit-resetEin Zeitstempel, der Ihnen anzeigt, wann Ihr Limit zurückgesetzt wird.

Der richtige Ansatz ist exponentielles Backoff: wenn du einen 429Warte eine Sekunde und versuche es dann erneut. Wenn es erneut fehlschlägt, warte zwei Sekunden, dann vier und so weiter. So kann deine App sich erholen, ohne die API zu überlasten.

Häufige Fragen

Was ist mit den alten Twitter API-Endpunkten passiert?

Die meisten der alten v1.1-Endpunkte sind entweder verschwunden oder in kostenpflichtige Tarife integriert worden. Die v2 API ist die aktuelle Version. Der Zugang zu älteren Versionen ist nicht mehr verfügbar. Überprüfen Sie die offizielle X API-Dokumentation, um herauszufinden, wo die benötigte Funktionalität jetzt zu finden ist – gehen Sie nicht davon aus, dass alte Endpunkte noch funktionieren.

Wie gehe ich mit Rate Limits um?

Sei proaktiv. Warte nicht auf die 429 um dich zu erreichen. Schau dir die x-rate-limit-remaining Header in jeder Antwort, um zu sehen, wie viele Aufrufe Ihnen noch zur Verfügung stehen. Und falls Sie doch einen erhalten... 429Implementiere exponentielles Backoff.

Was ist der beste Weg, um historische Daten zu erhalten?

Vollständige historische Daten sind eine Premium-Funktion. Sie benötigen Pro- oder Enterprise-Zugang, um den Full-Archive Search-Endpunkt nutzen zu können. Die kostenlosen und Basic-Tarife decken nur aktuelle Daten ab.

Müde davon, sich mit einzelnen Social-Media-APIs herumzuschlagen? Late bietet eine einheitliche API, um Inhalte auf X, Instagram, TikTok und sieben weiteren Plattformen zu planen und zu veröffentlichen. Du kannst in weniger als 15 Minuten kostenlos mit dem Aufbau beginnen..