Zum Hauptinhalt springen

​
Übersicht

Das Feld metrics ermöglicht Entwicklerinnen und Entwicklern den Zugriff auf öffentliche und private Engagement-metrics für Post- und Medienobjekte. Öffentliche metrics sind für alle mit einem Developer-Konto zugänglich, während private metrics über eigene/autorisierte Konten zugänglich sind (Definition unten). Metrics umfassen die Gesamtzahl der Impressions, Retweets, Quote Tweets, likes, Antworten, Videoaufrufe, Video-View-Quartile sowie Klicks auf URL- und Profil-Links für jeden in der Anfrage angegebenen Post. Es besteht außerdem die Möglichkeit, eine Aufschlüsselung der in einem organischen oder beworbenen Kontext erzielten metrics anzuzeigen, falls der Post als Ad beworben wurde. Öffentliche metrics können mit der Authentifizierung über App-only Token angefordert werden. Nicht öffentliche metrics können nur für eigene/autorisierte Posts angefordert werden. Das bedeutet, dass sich Entwicklerinnen und Entwickler mit einer Benutzerkontext-Autorisierung über OAuth 2.0 oder OAuth 1.0a authentifizieren müssen. Nicht öffentliche, organische und beworbene metrics sind nur für Posts verfügbar, die in den letzten 30 Tagen erstellt wurden.

​
Terminologie

  • Autorisierter Account: Ein X Account, der deiner X Developer-App Zugriff auf diesen Account gewährt hat (jedes App-Berechtigungsniveau erlaubt den Zugriff auf Post metrics).
  • Zugehöriger Account: Ein X Account, der mit deiner X Developer-App verknüpft ist.
  • Öffentliche metrics: Summen, auf die jeder auf X zugreifen kann, z. B. die Anzahl der likes und die Anzahl der Retweets.
  • Nicht öffentliche metrics: Summen, die nicht öffentlich auf X einsehbar sind, z. B. die Anzahl der Impressions und Video-View-Quartile. Erfordert OAuth 2.0 oder OAuth 1.0a Benutzerkontext-Authentifizierung.
  • Organische metrics: Eine Zusammenstellung aus öffentlichen und nicht öffentlichen metrics, die einem organischen Kontext zugeordnet sind (regulär veröffentlicht und betrachtet). Erfordert OAuth 2.0 oder OAuth 1.0a Benutzerkontext-Authentifizierung.
  • Promoted metrics: Eine Zusammenstellung aus öffentlichen und nicht öffentlichen metrics, die einem beworbenen Kontext zugeordnet sind (im Rahmen einer Ads-Kampagne veröffentlicht oder betrachtet). Erfordert OAuth 2.0 oder OAuth 1.0a Benutzerkontext-Authentifizierung sowie, dass der Post in einer Ad beworben wurde.

​
Verfügbare Metrics

MetrikAPI-DarstellungenBeschreibung
Impressionsdata.non_public_metrics.impression_count, data.organic_metrics.impression_count, data.promoted_metrics.impression_countAnzahl der Aufrufe des Posts (nicht nutzerunabhängig/unique). Ein Aufruf wird gezählt, wenn ein Teil des Posts auf dem Bildschirm sichtbar ist. Erfordert OAuth 1.0a User Context-Authentifizierung.
Retweetsdata.public_metrics.retweet_count, data.organic_metrics.retweet_count, data.promoted_metrics.retweet_countAnzahl der Retweets des Posts. Enthält keine Quote Tweets („Retweets mit Kommentar“). Um die in X-Clients angezeigte Summe „Retweets und Kommentare“ zu erhalten, addieren Sie retweet_count und quote_count.
Quote Tweetsdata.public_metrics.quote_countAnzahl der Male, die der Post mit einem neuen Kommentar (Nachricht) retweetet wurde. Es gibt keine Quote Tweets aus bezahltem Kontext, daher sind alle Quote Tweets organisch.
Likesdata.public_metrics.like_count, data.organic_metrics.like_count, data.promoted_metrics.like_countAnzahl der Likes für den Post. Das Feld public_metrics liefert die Gesamtzahl der Likes aus organischem und bezahltem Kontext, um Konsistenz mit den öffentlich auf X angezeigten Zählwerten sicherzustellen.
Repliesdata.public_metrics.reply_count, data.organic_metrics.reply_count, data.promoted_metrics.reply_countAnzahl der Antworten auf den Post. Das Feld public_metrics liefert die Gesamtzahl der Antworten aus organischem und bezahltem Kontext.
URL-Link-Klicksdata.non_public_metrics.url_link_clicks, data.organic_metrics.url_link_clicks, data.promoted_metrics.url_link_clicksAnzahl der Klicks eines Nutzers auf einen URL-Link oder eine URL-Vorschaukarte in einem Post. Erfordert OAuth 1.0a User Context-Authentifizierung.
Klicks auf Nutzerprofildata.non_public_metrics.user_profile_clicks, data.organic_metrics.user_profile_clicks, data.promoted_metrics.user_profile_clicksAnzahl der Klicks eines Nutzers auf Teile eines Posts: Anzeigename, Nutzername, Profilbild. Erfordert OAuth 1.0a User Context-Authentifizierung.
Videoaufrufeincludes.media.public_metrics.view_count, includes.media.organic_metrics.view_count, includes.media.promoted_metrics.view_countAnzahl der Aufrufe des im Post enthaltenen Videos. Dies ist die Zahl der Videoaufrufe, aggregiert über alle Posts, in denen das betreffende Video gepostet wurde. Erfordert Media-Expansion expansions=attachment.media_keys.
Video-View-Quartileincludes.media.non_public_metrics.playback_0_count, includes.media.non_public_metrics.playback_25_count, includes.media.non_public_metrics.playback_50_count, includes.media.non_public_metrics.playback_75_count, includes.media.non_public_metrics.playback_100_countAnzahl der Nutzer, die jedes Quartil eines Videos abgespielt haben. Erfordert OAuth 1.0a User Context-Authentifizierung und Media-Expansion expansions=attachment.media_keys.

​
Anfordern von metrics

​
Öffentliche Metriken

In der folgenden Anfrage rufen wir öffentliche metrics für den Post und das angehängte Video mit den folgenden fields und der folgenden expansions ab. Ersetzen Sie dabei $BEARER_TOKEN durch Ihren eigenen generierten Bearer Token.
  • tweet.fields=public_metrics
  • expansions=attachments.media_keys&media.fields=public_metrics

​
Beispielanfrage

curl 'https://api.x.com/2/tweets?ids=1204084171334832128&tweet.fields=public_metrics&expansions=attachments.media_keys&media.fields=public_metrics' --header 'Authorization: Bearer $BEARER_TOKEN'

​
Private Metriken (nicht öffentlich, organische Metriken)

Die folgende Anfrage fordert nicht öffentliche Metriken mit zusätzlichen Details zu organischen Metriken für den Post und das angehängte Video an. Da diese fields privat sind und nicht öffentlich auf X einsehbar sind, erfordert die Anfrage eine Authentifizierung im Benutzerkontext über OAuth 2.0 oder OAuth 1.0a. Weitere Informationen zum Generieren der unten benötigten OAuth 1.0a-Signatur finden Sie in unserem Leitfaden.
  • tweet.fields=non_public_metrics,organic_metrics
  • expansions=attachments.media_keys&media.fields=non_public_metrics,organic_metrics

​
Beispielanfrage

curl 'https://api.x.com/2/tweets/1204084171334832128?tweet.fields=non_public_metrics,organic_metrics&media.fields=non_public_metrics,organic_metrics&expansions=attachments.media_keys' --header 'authorization: OAuth oauth_consumer_key="CONSUMER_API_KEY", oauth_nonce="OAUTH_NONCE", oauth_signature="OAUTH_SIGNATURE", oauth_signature_method="HMAC-SHA1", oauth_timestamp="OAUTH_TIMESTAMP", oauth_token="ACCESS_TOKEN", oauth_version="1.0"'

​
Beispielantwort

{
  "data": {
    "attachments": {
      "media_keys": ["13_1204080851740315648"]
    },
    "id": "1263145271946551300",
    "non_public_metrics": {
      "impression_count": 956,
      "url_link_clicks": 9,
      "user_profile_clicks": 34
    },
    "organic_metrics": {
      "impression_count": 956,
      "like_count": 49,
      "reply_count": 2,
      "retweet_count": 9,
      "url_link_clicks": 9,
      "user_profile_clicks": 34
    },
    "text": "test"
  },
  "includes": {
    "media": [
      {
        "media_key": "13_1204080851740315648",
        "non_public_metrics": {
          "playback_0_count": 0,
          "playback_100_count": 1,
          "playback_25_count": 2,
          "playback_50_count": 1,
          "playback_75_count": 1
        },
        "organic_metrics": {
          "playback_0_count": 0,
          "playback_100_count": 1,
          "playback_25_count": 2,
          "playback_50_count": 1,
          "playback_75_count": 1,
          "view_count": 1
        },
        "type": "video"
      }
    ]
  }
}
⌘I