Zum Hauptinhalt springen

​
Einführung

Während das recent search endpoint nur das Abrufen von Posts ermöglicht, die in den letzten 7 Tagen veröffentlicht wurden, erlauben die Endpoints für die Benutzer-Post-Timeline und die Benutzer-Erwähnungs-Timeline das Abrufen von Posts und Erwähnungen, die älter als 7 Tage sind, für einen autorisierten Benutzer (unter Verwendung der user id). Entwickler können diese Endpoints nutzen, um Themen, Entitäten und die Stimmung von Posts aus der Timeline oder den Erwähnungen eines Benutzers zu analysieren. In diesem Tutorial zeigen wir, wie Sie die Posts und Erwähnungen eines Benutzers mithilfe der Endpoints für die User-Tweet-Timeline und die User-Mention-Timeline erkunden.  

​
Voraussetzungen

  • Um die endpoints für die Nutzer-Tweet-Timeline und die Nutzer-Erwähnungs-Timeline zu verwenden, benötigen Sie ein gültiges Developer-Konto.
  • Außerdem benötigen Sie ein Project.
  • Sie müssen sich für ein Developer-Konto registriert und die neue Entwicklerportal-Oberfläche aktiviert haben.
  • Der Zugriff ist mit aktiven Keys und Tokens für eine Developer-App möglich, die einem im Entwicklerportal erstellten Project zugeordnet ist.
  • Ein Bearer Token aus Ihrer App im X Entwicklerportal.
  • Wenn Sie kein genehmigtes Developer-Konto haben, können Sie Zugang beantragen.

​
Genehmigtes Developer-Konto

Wenn Sie noch keines haben, können Sie eines beantragen.

​
Erstellen Sie ein Project und verbinden Sie eine App

Im Entwicklerportal klicken Sie auf Neues Project erstellen.
Geben Sie einen Namen ein, wählen Sie den passenden Anwendungsfall aus und fügen Sie eine Project-Beschreibung hinzu. Anschließend können Sie entweder eine neue App erstellen oder eine bestehende App verknüpfen (eine App ist ein Container für Ihre API Keys, die Sie benötigen, um eine HTTP-Anfrage an die X API zu stellen).
Klicken Sie auf „create a new App instead“ und geben Sie Ihrer App einen Namen, um eine neue App zu erstellen.
Sobald Sie auf Fertig klicken, erhalten Sie Ihre API Keys und das Bearer Token, die Sie anschließend verwenden können, um sich mit den neuen endpoints in der X API v2 zu verbinden.
Klicken Sie auf das (+) neben API Key, API Secret Key und Bearer Token und kopieren Sie diese Werte an einen sicheren Ort auf Ihrem lokalen Rechner. Sie benötigen diese, um im nächsten Schritt die API-Aufrufe durchzuführen. Hinweis: Die Schlüssel im obigen Screenshot sind ausgeblendet, aber in Ihrem eigenen Entwicklerportal können Sie die tatsächlichen Werte für den API Key, API Secret Key und Bearer Token sehen.  

​
So erhalten Sie die Nutzer-ID für die Verwendung in den Endpoints „user Tweet timeline“ und „user mention timeline“

Die Endpoints „user Tweet timeline“ und „user mention timeline“ ermöglichen es, Posts mithilfe der Nutzer-ID abzurufen. Um die Nutzer-ID anhand eines Benutzernamens zu ermitteln, können Sie den neuen user lookup endpoint v2 verwenden. Ersetzen Sie USER_NAME durch den gewünschten Benutzernamen und XXXX durch Ihr eigenes oben erhaltenes Bearer Token. 
  curl --request GET 'https://api.x.com/2/users/by/username/USER_NAME --header 'Authorization: Bearer XXXXXX'
Die Benutzer-id wird in der Antwort wie unten gezeigt angezeigt: 
{
   "data": {
       "id": "2244994945",
       "name": "Entwickler",
       "username": "XDevelopers"
   }
}

​
Verbindung mit den endpoints für die User-Tweet-Timeline und die User-Mentions-Timeline

Um die User-Tweet-Timeline für einen Nutzer abzurufen, führen Sie den folgenden curl-Befehl in Ihrem Terminal aus (ersetzen Sie dabei USER_ID durch die gewünschte user id und XXXX durch Ihr eigenes Bearer Token, das Sie oben erhalten haben) 
curl --request GET 'https://api.x.com/2/users/USER_ID/tweets' --header 'Authorization: Bearer XXXXXX'
Sie werden sehen, dass die JSON-Antwort für diese Anfragen standardmäßig die id und den Text der Posts enthält (Beispiel unten). 
{
   "id": "1334200897081987072",
   "text": "👀 Wenn Sie neu bei der X API v2 sind, schauen Sie sich diese Schritt-für-Schritt-Anleitung für Ihre erste Anfrage an https://t.co/4rZqThpSbp"
}
Wenn Sie zusätzliche fields als Teil der Antwort zurückgeben möchten (z. B. Benutzerinformationen, zusätzliche Tweet fields wie context annotations usw.), müssen Sie diese fields in Ihrer Anfrage ausdrücklich angeben. Wie das funktioniert, erfahren Sie im Leitfaden zur Verwendung von fields und expansions. Sie können diese Posts auch mit Programmiersprachen Ihrer Wahl abrufen. Sehen Sie sich unseren Beispielcode in Python, Node (JavaScript), Java und Ruby für die endpoints der User-Tweet-Timeline und der User-Mention-Timeline in unserem GitHub-Repository an.

​
Erkundung der Posts eines Nutzers

Sobald Sie wissen, wie Sie Posts über die Endpoints für die Tweet-Timeline eines Nutzers und die Erwähnungs-Timeline eines Nutzers per GET abrufen, können Sie beginnen, dessen Posts zu untersuchen. Wenn Sie beispielsweise häufig vorkommende benannte Entitäten in den Erwähnungen eines Nutzers identifizieren möchten, können Sie Folgendes tun: Geben Sie in der API-Anfrage an, dass das Objekt context_annotations in den Tweet-Antworten zurückgegeben wird: 
curl --request GET 'https://api.x.com/2/users/USER_ID/mentions?tweet.fields=context_annotations' --header 'Authorization: Bearer XXXXXX'
In der Antwort sehen Sie, ob in den Erwähnungen Named Entities vorhanden sind. Hier ein Beispiel: 
{
   "domain": {
       "id": "47",
       "name": "Brand",
       "description": "Marken und Unternehmen"
   },
   "entity": {
       "id": "783214",
       "name": "X"
   }
}
Wenn Sie sehen möchten, welche häufig vorkommenden Entitäten in Ihren Erwähnungen erscheinen, könnten Sie eine Zählung dieser Entitäten führen, indem Sie jeden Tweet in den Erwähnungen parsen. Wenn Sie die Vorschau-Bild-URL für alle Posts in Ihrer Timeline untersuchen möchten, die Medien enthalten, können Sie Folgendes tun: Geben Sie in der API-Anfrage an, dass Sie preview_image_url in den tweet.media fields und die attachments.media_keys expansions anfordern 
curl --request GET 'https://api.x.com/2/users/2244994945/mentions?max_results=100&media.fields=preview_image_url&expansions=attachments.media_keys' --header 'Authorization: Bearer XXXXXX'
In der Antwort sehen Sie preview_image_url im includes-Objekt, wie unten gezeigt: 
{
   "includes": {
       "media": [
           {
               "media_key": "16_1334657439640121344",
               "preview_image_url": "https://pbs.twimg.com/tweet_video_thumb/EoWn3rqU8AAtFWL.jpg",
               "type": "animated_gif"
           }
       ]
   }
}
Sobald Sie verstanden haben, wie Sie in den Posts eines Nutzers navigieren, können Sie auch andere APIs und Dienste nutzen, um noch mehr mit den Posts zu machen. Nachfolgend finden Sie einige Ressourcen, die Sie bereithalten sollten, wenn Sie die endpoints für die Nutzer-Tweet-Timeline und die Nutzer-Erwähnungs-Timeline verwenden.

​
Ressourcen

⌘I