Was ist die Twitter-API?
Twitter API ist eine Schnittstelle, über die eine Website oder App mit Twitter interagieren kann. Sie ermöglicht den Zugriff auf die wichtigsten Funktionen der Plattform, wie Tweets posten, Retweeten und Tweets finden, die ein bestimmtes Wort enthalten – über eine Website. Das wird dank der sogenannten Endpunkte möglich – Adressen, die einem bestimmten Typ von bereitgestellten Informationen entsprechen. Tweets, Antworten, Direktnachrichten, Anzeigen und Publisher-Tools lassen sich dank der Twitter-API einfach abrufen.
Wie Sie den Twitter-API-Schlüssel erhalten – Anleitung
Um Twitter mit Ihrer Website zu verbinden, benötigen Sie natürlich ein Konto. Falls Sie noch keines haben, erstellen Sie einen Twitter-API-Schlüssel.
Schritt 1: Ein Twitter-Entwicklerkonto eröffnen
Zuerst gehen Sie zum Bereich für Entwickler.
Schritt 2: Entwicklerkonto beantragen
Registrieren Sie sich mit Ihrem Entwicklerkonto auf der Twitter-Entwicklerplattform.
Zuerst müssen Sie Informationen über Ihre zukünftige Anwendung einreichen, die Twitter-Daten verwenden wird.
Schritt 3: Wählen Sie den Grund für die Verwendung des Twitter-API-Schlüssels
Es kann die Erstellung einer Twitter-Bot-API, Lehren, akademische Forschung und einiges mehr umfassen.
Schritt 4: Füllen Sie die erforderlichen Felder aus
Wähle dein Land, in dem du lebst, und notiere den Namen, unter dem dich ein Twitter-Team anrufen soll. Drücke Weiter.
Schritt 5: Beantworten Sie detaillierte Fragen zu Ihrer zukünftigen App.
Es gibt mehrere Fragen mit Feldern von mindestens 100 Zeichen. Sie müssen die projektspezifischen Daten dort eintragen, wo Sie Twitter verwenden werden.
Außerdem können Sie die Variante wählen, bei der Sie Twitter-Daten ohnehin nicht analysieren.
Schritt 6: Prüfen Sie die Informationen.
Wenn alles passt, klicken Sie auf „Looks good!“
Schritt 7: Die Entwicklerbedingungen lesen
Überprüfen und akzeptieren Sie sie, indem Sie auf „Bewerbung absenden“ klicken. Bitte beachten Sie, dass Sie vor dem Absenden der Bewerbung auf Twitter eine verifizierte E-Mail-Adresse haben sollten.
Ausstehende Vorgänge dauern fast einen Tag – einige Entwickler berichten, sie würden seit Monaten warten. Falls Sie sich entschieden haben, eine Twitter-basierte App zu erstellen, warten Sie nicht bis zur letzten Minute.
Prüfen Sie alles sorgfältig! Twitter prüft alles sehr gründlich, und wenn Ihr Anwendungsfall verdächtig erscheint, wird der Antrag abgelehnt. Sie können gegen diese Entscheidung keinen Einspruch einlegen.
Sobald Sie für den Entwicklerzugang berechtigt sind, wechseln Sie zur zweiten Phase – der Erstellung eines API-Schlüssels.
Schritt 8: Klicken Sie auf die Registerkarte Apps.
Als Nächstes gehen Sie zum Abschnitt Consumer API-Schlüssel. Kopieren Sie Ihren API-Schlüssel (den Sie in Ihrem Code in ein ACCESS_TOKEN-Feld einfügen) und API-Geheimnis (das eine ACCESS_SECRET-Eigenschaft sein wird).
Kopieren Sie „Access token“ und „Access token secret“. Sie finden diese nach dem Scrollen zum Abschnitt „Access token & access token secret“. Klicken Sie auf „Create“.
Schritt 9: Herzlichen Glückwunsch!
Schließlich haben Sie Ihren Twitter-API-Schlüssel und Zugriffstoken. Wählen Sie nun aus, welche Twitter-Inhalte Sie auf der Website anzeigen möchten – interaktiv oder statisch.
Twitter-API-Zugangsdaten
Zusammengefasst benötigen Sie Benutzerzugriffstoken mithilfe einer dreistufigen Authentifizierung: Client-Anmeldeinformationen, Temporäre Anmeldeinformationen, Token-Anmeldeinformationen.
Twitter-API-Beispiele
Es gibt zwei Haupttypen von APIs: Streaming-API und REST-APIs. Die Streaming-API dient dazu, Tweets in Echtzeit auf einer Website zu veröffentlichen, REST-APIs hingegen zeigen bestimmte Inhaltstypen (nur historische Tweets, Kommentare oder nur Follower). Werfen wir zunächst einen genaueren Blick auf die Streaming-API.
Twitter-Streaming-API
Die Streaming-API ermöglicht es nicht, Inhalte zu bearbeiten: Sie zeigt einfach die benötigten Tweets von Twitter in Echtzeit an. Wenn Sie die App trennen, trennen Sie sich zwangsläufig auch von ihrer API. Sobald Sie eine Verbindung zu Twitter herstellen, erhalten Sie einen Datenstrom verschiedener Arten: Tweets, Keep-Alive-Signale (die verhindern, dass die Verbindung ausläuft) und Systemnachrichten. Die Twitter-Feed-API ist eines der typischen Beispiele für Streaming-APIs.
Twitter-Feed-API
Wenn Sie diese API in Ihrer App verwenden, erhalten Sie einen Twitter-Timeline-Feed – einen geordneten Tweet-Stream. Anschließend können Sie einen Status-Filter verwenden oder eine PowerTrack-API (nur für die Enterprise-Kategorie), die Tweets filtert.
Twitter-REST-APIs
REST steht für Representational State Transfer. Im Gegensatz zur Streaming-API dient es einer Request-Response-Beziehung: Ein Client fordert eindeutige, formatierte Daten an, und der Server liefert sie. REST-APIs sind zustandslos, während Streaming-APIs zustandsbehaftet sind. Außerdem verwenden REST-APIs die Methoden GET und POST. Es gibt zahlreiche Beispiele für Twitter-REST-APIs, je nach Funktion, die sie erfüllen, z. B. User-API, Twitter-Feeds-API, Twitter-Follower-API. Wir werden darauf weiter im Detail eingehen.
Twitter-Such-API
Sie können Tweets suchen und sie auf Ihrer Website präsentieren, mit vielen verschiedenen Parametern. Dazu gehören Geokodierung, Sprache, Ergebnis-Typ (neueste oder meistbeliebte Ergebnisse), Anzahl (Tweets pro Seite) und weitere.
Benutzer-API
Web-Entwickler verwenden in der Regel die User-API, um beispielsweise die Follower- und Freundesliste eines bestimmten Nutzers abzurufen. Es ist auch möglich, eine Zeitleiste der neuesten Tweets einer Person anzuzeigen.
Twitter API-Registrierung
Verwenden Sie die Schaltflächen Anmelden oder Mit Twitter anmelden, damit Benutzer die Vorteile ihrer Konten auf Ihrer Website nutzen können. Zunächst benötigen Sie ein Anforderungstoken, dann leiten Sie den Benutzer zu Twitter weiter und wandeln das Anforderungstoken in ein Zugriffstoken um.
Twitter-Tweets-API
Es ermöglicht das programmgesteuerte Erstellen, Wiederherstellen und Löschen von Tweets und Likes für Beiträge. Mittels der Post-API können Sie Tweets anzeigen und deren Status löschen. Die Twitter Tweets API ermöglicht außerdem das Abrufen von Tweets über die Twitter-API.
Trends API
Twitter-Trends auf der Website werden fast alle fünf Minuten aktualisiert. Sie erhalten weltweite Trends sowie lokale Trends. Um Informationen aus den Ländern, für die Sie sich interessieren, zu präsentieren, finden Sie eine Place-ID – eine 32-Bit-Kennung, bereitgestellt vom Yahoo! GeoPlanet-Projekt.
Twitter-Werbe-API
Diese API dient der programmgesteuerten Verwaltung von Werbekampagnen auf Twitter. Die Twitter-Entwickler ermöglichen es, die Effektivität Ihrer Werbekampagne auf der Plattform mithilfe der Twitter Analytics API zu analysieren.
Twitter-API-Statusmeldungen
Entwickler benötigen es, um den Status von Beiträgen abzurufen (z. B. Retweets und Favoriten).
Twitter-Geolocation-API
Sie ermöglicht, Informationen zu einem bestimmten Ort abzurufen und auch Orte in der Nähe eines Standorts zu finden. Die Geolocation-API hilft bei der Suche nach Orten, die mit Status oder Trends verknüpft sind. Die Abfrage liefert eine Liste aller gültigen Orte.
Twitter-API-Ratenbegrenzungen und Preise
In den meisten Fällen wird die Twitter-API von Entwicklern nicht kostenlos genutzt. Es gibt bestimmte Einschränkungen bei der Verwendung von Twitter-Daten in Projekten.
Bei der Nutzung der Twitter-Daten mit einem Standard-Abonnement stoßen Sie auf folgende Einschränkungen:
| Endpunkt | Ressourcenfamilie | POST-Limit-Fenster | POST pro Benutzer-Limit | Beiträge pro App-Limit |
| POST statuses/update | Inhalte erstellen | 3 Stunden | 300 | 300 |
| POST statuses/retweet/:id | Inhalte erstellen | 3 Stunden | 300 | 300 |
| POST favorites/create | Favoriten | 24 Stunden | 1000 | 1000 |
| POST friendships/create | Freundschaften | 24 Stunden | 400 | 1000 |
| POST direct_messages/events/new | Direktnachrichten | 24 Stunden | 1000 | 15000 |
Um mehr zu erfahren, lesen Sie Twitters Referenz zur Ratenbegrenzung. Dort finden Sie außerdem Informationen zu den GET-Endpunkten.
Im Wesentlichen gibt es drei Ebenen des Datenzugriffs, die dem Wachstum deines Projekts entsprechen: Standard, Premium und Enterprise. Die meisten Twitter-Funktionen sind kostenlos, aber für bessere Funktionalität und Zugriff musst du auf das Premium– oder Enterprise-Abonnementniveau umsteigen.
Nachfolgend finden Sie eine Tabelle mit den wichtigsten Twitter-APIs und der Verfügbarkeit der Abonnementstufen.
| Standard (kostenlos) | Premium (149 $/Monat – 2.499 $/Monat) | Enterprise (ab 2.499 USD und mehr) | |
| API veröffentlichen und integrieren | ✅ | ||
| Tweets API durchsuchen: 7 Tage | ✅ | ||
| Tweets-API: 30 Tage | ✅ | ✅ | |
| Konten- und Benutzer-APIs | ✅ | ✅ | ✅ |
| Werbe-APIs | ✅ | ||
| Website-Tools | ✅ |
Weitere Informationen zu Twitter-Abonnement-Stufen und Preisen finden Sie in deren Anfrage.
Twitter-API-Änderungen
Um die Funktionsweise des Twitter-API-Schlüssels zu verstehen, sollte man die Geschichte seiner Änderungen kennen.
2016 change: Die Such-API hat Unterstützung für einige Geo-Operatoren hinzugefügt, wie place, place_country und profile_region.
2017 Änderung: Historische PowerTrack-API und Replay-API wurden geändert. Sie unterstützen fortan das Filtern von Quote Tweets. Außerdem stehen Poll-Metadaten über Twitter-Unternehmens-APIs zur Verfügung.
2018 Änderung: Eine neue Version der Nutzungs-API wurde eingeführt. Dadurch haben Twitter-Entwickler die Möglichkeit, ihre bestehenden Twitter-Apps über das Twitter-App-Dashboard auf developer.twitter.com anzusehen und zu bearbeiten, während sie bei ihrem Twitter-Konto angemeldet sind.
2019 Änderung: Das PowerTrack-Historien-Format hat sich geändert; drei Werte stehen nun für Stapel-Tweets zur Verfügung: “name”, “description” und “location”. Außerdem wurde eine neue Funktion der Account Activity API veröffentlicht. Danach können Entwickler sehen, ob ein Konto, das Ihren abonnierten Benutzer erwähnt, blockiert ist.
2020 Änderung: Um Access Token und Access Token Secret sicherer zu machen, zeigen Twitter-Entwickler sie nach der ersten Generierung nicht mehr im Dashboard an.
Twitter-API-Dokumentation
Bevor Sie loslegen, werfen Sie einen Blick in die umfassende Dokumentation. Sie machen sich mit allen Methoden vertraut, die in allen API-Typen verwendet werden sollten. Außerdem freut sich Twitter darauf, mit Entwicklern zu interagieren. Die Plattform hat einen speziellen Arbeitsbereich für Programmierer eingeführt, in dem sie frühzeitig Zugriff auf neue API-Funktionen zum Testen erhalten. Twitter Developers’ Lab ist großartig, wenn Sie die Zukunft der App mitgestalten möchten.
FAQ (Häufig gestellte Fragen)
Was mache ich, wenn der Fehler: “Twitter API bad authentication data” auftritt?
Der Fehlercode lautet 215. Er entspricht HTTP 400. Die Methode erfordert eine Authentifizierung, die nicht vorgelegt wurde oder völlig ungültig war.
Was bedeutet „Serverfehler – Anwendung wurde nicht eingereicht“?
Dieser Fehler tritt auf, weil Sie Ihr Twitter-Konto nicht verifiziert haben. Öffnen Sie einfach den Einstellungsreiter in Ihrem Profil, suchen Sie das E-Mail-Feld und folgen Sie den weiteren Anweisungen.
Was ist, wenn meine Twitter-Anwendung nicht genehmigt wird?
Leider können Sie diese Entscheidung nicht anfechten. Sie können beispielsweise keine weitere Anfrage oder App erstellen.
Wo finde ich alle Twitter-API-Fehlercodes?
Eine Tabelle mit allen Fehlern, die bei der Nutzung der Standard-API auftreten, finden Sie auf der Seite mit Twitter-Antwortcodes.
Twitter-API-Rate-Limit überschritten. Was bedeutet das und was soll ich tun?
Drittentwickler können die Twitter-API in ihren Apps nutzen, aber es gibt bestimmte Beschränkungen. Beispielsweise dürfen Sie nicht mehr als 100 Aufrufe pro Stunde tätigen. Überschreitet das Kontingent, erscheint diese Meldung. Warten Sie bis zum Ende der Stunde oder wechseln Sie zum nächsten Abonnementplan (Premium oder Enterprise).
Fazit
Einen Twitter-API-Schlüssel zu erhalten, ist kein langer oder komplizierter Prozess. Allerdings kann es für Anfänger etwas herausfordernd sein: Machen Sie sich mit der Dokumentation, Preisgestaltung und den Beschränkungen vertraut.
Sie können in Sekundenschnelle Tweets veröffentlichen, wenn Sie fertige Apps verwenden, z. B. Twitter Feed von Elfsight. Dafür benötigen Sie keinen Twitter-API-Schlüssel oder Programmierkenntnisse.
