Zum Hauptinhalt springen
Diese Seite enthält Informationen zu mehreren Tools und zentralen Konzepten, die Ihnen helfen, die Posts-Lookup-endpoints in Ihr System zu integrieren. Wir haben die Seite in mehrere Abschnitte gegliedert:

​
Nützliche Tools

Bevor wir in einige zentrale Konzepte eintauchen, empfehlen wir, sich mit den folgenden Tools vertraut zu machen: Postman
Postman ist ein hervorragendes Tool, um ein endpoint zu testen – einschließlich aller Pfad- und Body-Parameter –, sodass Sie verstehen, was verfügbar ist. Weitere Informationen finden Sie in unserem Leitfaden für den Einstieg mit Postman. Codebeispiele
Finden Sie Codebeispiele für Ihre bevorzugte Programmiersprache auf unserer GitHub-Seite. Bibliotheken von Drittanbietern
Nutzen Sie von der Community erstellte Bibliotheken von Drittanbietern, die mit v2 endpoints kompatibel sind.

​
Schlüsselkonzepte

​
Authentifizierung

Alle X API v2 Endpoints erfordern authentifizierte Anfragen. Sie können sich authentifizieren mit:
OAuth 1.0a kann in der Implementierung anspruchsvoll sein. Wenn Sie damit nicht vertraut sind, ziehen Sie für Anfragen die Verwendung einer Bibliothek oder von OAuth 2.0 in Betracht. Für private metrics oder Posts verwenden Sie OAuth 1.0a User Context oder OAuth 2.0 Authorization Code mit PKCE.
Bitte beachten
Wenn Sie die folgenden fields anfordern, sind OAuth 1.0a User Context oder OAuth 2.0 Authorization Code erforderlich:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
Entwicklerportal, Projects und Apps

Um Zugangsdaten für die X API v2 zu erhalten, benötigen Sie:
  1. Ein genehmigtes Developer-Konto.
  2. Ein Project innerhalb des Developer-Kontos.
  3. Eine Developer-App innerhalb dieses Projects, in der Keys und Tokens zu finden sind.

​
Rate Limits

X API-Anfragen unterliegen Rate Limits, um das Volumen zu steuern. Limits gelten sowohl auf App- als auch auf Benutzerebene:
  • App-Ebene: Begrenzt die Anzahl der von einer App pro Zeitraum gestellten Anfragen.
  • Benutzerebene: Begrenzt, wie häufig ein authentifizierter Benutzer Post-Lookups über Developer-Apps durchführen kann.

​
Felder und Expansions

Die X API v2 ermöglicht die Auswahl bestimmter Datenfelder mithilfe von fields und expansions:
  • Expansions: Ermöglichen das Abrufen zusätzlicher, verwandter Objekte. Unterstützte Expansions sind:
    • edit_history_tweet_ids
    • attachments.poll_ids
    • attachments.media_keys
    • author_id
    • entities.mentions.username
    • geo.place_id
    • in_reply_to_user_id
    • referenced_tweets.id
    • referenced_tweets.id.author_id
  • Fields: Geben Datenfelder innerhalb von Objekten an, die für zusätzliche Informationen zurückgegeben werden sollen. Das Post-Objekt umfasst standardmäßig id, text und edit_history_tweet_ids. Weitere Optionen wie tweet.created_at und tweet.entities müssen explizit angefordert werden.
Weitere Informationen finden Sie im Leitfaden zu fields und expansions im X API v2 Data Dictionary.

​
Post-Bearbeitungen

Berechtigte Posts können bis zu fünfmal innerhalb von 30 Minuten nach der Veröffentlichung bearbeitet werden. Das Posts-Lookup-endpoint liefert stets die neueste Post-Version. Für Anwendungsfälle mit nahezu Echtzeitverarbeitung beachten Sie dieses Zeitfenster. Weitere Details finden Sie unter Grundlagen zur Bearbeitung von Posts.

​
Randfälle

  • Promoted metrics: Das Anfordern von promoted metrics für nicht beworbene Posts führt zu einer leeren Antwort.
  • Gekürzter Text: Der Post-Text wird bei Retweets gekürzt. Um den vollständigen Text abzurufen, erweitern Sie den referenzierten Post
⌘I