Saltar al contenido principal

​
Descripción general

El campo metrics permite a los desarrolladores acceder a métricas de interacción públicas y privadas para objetos Post y de medios. Las métricas públicas están disponibles para cualquier persona con una cuenta de desarrollador, mientras que las métricas privadas están disponibles para cuentas propias/autorizadas (definición a continuación). Las métricas incluyen el recuento total de impresiones, Retweets, Tweets citados, Me gusta, respuestas, reproducciones de video, cuartiles de reproducción de video y clics en URL y en enlaces de perfil para cada Post especificado en la solicitud. También existe la opción de ver un desglose de las métricas obtenidas en un contexto orgánico o promocionado, si el Post se promocionó como un Ad. Las métricas públicas se pueden solicitar con autenticación de App-only Token. Las métricas no públicas se pueden solicitar solo para Posts propios/autorizados, lo que significa que los desarrolladores deben autenticarse mediante OAuth 2.0 o autorización en contexto de usuario con OAuth 1.0a. Las métricas no públicas, orgánicas y promocionadas solo están disponibles para Posts creados en los últimos 30 días.

​
Terminología

  • Cuenta autorizada: Una cuenta de X que ha autorizado tu App de desarrollador de X al concederle acceso a esa cuenta (cualquier nivel de permisos de la App permitirá el acceso a las métricas de Post).
  • Cuenta propia: Una cuenta de X vinculada a tu App de desarrollador de X.
  • Métricas públicas: Totales a los que cualquiera puede acceder en X, como el número de Me gusta y el número de Retweets.
  • Métricas no públicas: Totales que no están disponibles para su visualización pública en X, como el número de impresiones y los cuartiles de visualización de video. Requiere autenticación de usuario con OAuth 2.0 o OAuth 1.0a.
  • Métricas orgánicas: Un conjunto de métricas públicas y no públicas atribuidas a un contexto orgánico (publicadas y vistas de manera regular). Requiere autenticación de usuario con OAuth 2.0 o OAuth 1.0a.
  • Métricas promocionadas: Un conjunto de métricas públicas y no públicas atribuidas a un contexto promocionado (publicadas o vistas como parte de una campaña de Ads). Requiere autenticación de usuario con OAuth 2.0 o OAuth 1.0a y que el Post haya sido promocionado en un Ad.

​
Métricas disponibles

MétricaRepresentaciones en la APIDescripción
Impressionsdata.non_public_metrics.impression_count, data.organic_metrics.impression_count, data.promoted_metrics.impression_countRecuento de cuántas veces se ha visto el Post (no únicas por usuario). Se cuenta una vista si cualquier parte del Post es visible en la pantalla. Requiere autenticación en Contexto de usuario de OAuth 1.0a.
Retweetsdata.public_metrics.retweet_count, data.organic_metrics.retweet_count, data.promoted_metrics.retweet_countRecuento de cuántas veces se ha hecho Retweet del Post. No incluye Quote Tweets (“Retweets con comentario”). Para obtener el total de “Retweets y comentarios” tal como se muestra en los clientes de X, suma retweet_count y quote_count.
Quote Tweetsdata.public_metrics.quote_countRecuento de cuántas veces el Post ha sido Retweeteado con un nuevo comentario (mensaje). No hay Quote Tweets en un contexto de pago, por lo que todos los Quote Tweets son orgánicos.
Likesdata.public_metrics.like_count, data.organic_metrics.like_count, data.promoted_metrics.like_countRecuento de cuántas veces se ha indicado que gusta el Post. El campo public_metrics devuelve el recuento total de Me gusta de contextos tanto orgánicos como de pago para mantener la coherencia con los recuentos que se muestran públicamente en X.
Repliesdata.public_metrics.reply_count, data.organic_metrics.reply_count, data.promoted_metrics.reply_countRecuento de cuántas veces se ha respondido al Post. El campo public_metrics devuelve el recuento total de respuestas de contextos tanto orgánicos como de pago.
URL Link Clicksdata.non_public_metrics.url_link_clicks, data.organic_metrics.url_link_clicks, data.promoted_metrics.url_link_clicksRecuento del número de veces que un usuario hace clic en un enlace URL o en una tarjeta de vista previa de URL en un Post. Requiere autenticación en Contexto de usuario de OAuth 1.0a.
User Profile Clicksdata.non_public_metrics.user_profile_clicks, data.organic_metrics.user_profile_clicks, data.promoted_metrics.user_profile_clicksRecuento del número de veces que un usuario hace clic en partes de un Post: nombre para mostrar, nombre de usuario, foto de perfil. Requiere autenticación en Contexto de usuario de OAuth 1.0a.
Video viewsincludes.media.public_metrics.view_count, includes.media.organic_metrics.view_count, includes.media.promoted_metrics.view_countRecuento de cuántas veces se ha visto el video incluido en el Post. Este es el número de visualizaciones de video agregadas en todos los Posts en los que se ha publicado el video. Requiere la expansión de medios expansions=attachment.media_keys.
Video view quartilesincludes.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_countNúmero de usuarios que reproducen cada cuartil de un video. Requiere autenticación en Contexto de usuario de OAuth 1.0a y la expansión de medios expansions=attachment.media_keys.

​
Solicitud de métricas

​
Métricas públicas

En la siguiente solicitud, pedimos métricas públicas del Post y del video adjunto con los siguientes fields y expansion. Asegúrate de reemplazar $BEARER_TOKEN por tu propio bearer token generado.
  • tweet.fields=public_metrics
  • expansions=attachments.media_keys&media.fields=public_metrics

​
Ejemplo de solicitud

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'

​
Métricas privadas (no públicas, métricas orgánicas)

La siguiente solicitud solicita métricas no públicas con detalles adicionales sobre métricas orgánicas para el Post y el video adjunto. Dado que estos campos son privados y no están disponibles para su visualización pública en X, la solicitud requiere autenticación de OAuth 2.0 o OAuth 1.0a con contexto de usuario. Consulta nuestra guía para generar la firma de OAuth 1.0a necesaria a continuación.
  • tweet.fields=non_public_metrics,organic_metrics
  • expansions=attachments.media_keys&media.fields=non_public_metrics,organic_metrics

​
Ejemplo de solicitud

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"'

​
Respuesta de muestra

{
  "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"
      }
    ]
  }
}