Saltar al contenido principal

​
Descripción general

El campo metrics permite a los desarrolladores acceder a metrics de interacción públicas y privadas para objetos Post y de medios. Las metrics públicas están disponibles para cualquier persona con una cuenta de desarrollador, mientras que las metrics privadas están disponibles desde cuentas propias/autorizadas (definición a continuación). Las metrics incluyen el recuento total de impresiones, Retweets, Quote Tweets, likes, 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 metrics obtenidas en un contexto orgánico o promocionado, si el Post se promocionó como un Ad. Las metrics públicas se pueden solicitar con autenticación App-only Token. Las metrics no públicas solo se pueden solicitar para Posts propios/autorizados, lo que significa que los desarrolladores deben autenticarse mediante autorización con contexto de usuario con OAuth 2.0 o OAuth 1.0a. Las metrics 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 X developer app otorgándole acceso a esa cuenta (cualquier app permission level permitirá el acceso a Post metrics).
  • Cuenta de tu propiedad: Una cuenta de X vinculada a tu X developer app.
  • Public metrics: Totales disponibles para cualquiera en X, como la cantidad de likes y de Retweets.
  • Non-public metrics: Totales que no están disponibles para el público en X, como la cantidad de impresiones y los cuartiles de visualización de video. Requiere autenticación con contexto de usuario mediante OAuth 2.0 o OAuth 1.0a.
  • Organic metrics: Un conjunto de public y non-public metrics atribuible a un contexto orgánico (publicado y visto de manera regular). Requiere autenticación con contexto de usuario mediante OAuth 2.0 o OAuth 1.0a.
  • Promoted metrics: Un conjunto de public y non-public metrics atribuible a un contexto promocionado (publicado o visto como parte de una campaña de Ads). Requiere autenticación con contexto de usuario mediante 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
Impresionesdata.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 único por usuario). Se cuenta una vista si cualquier parte del Post es visible en la pantalla. Requiere autenticación con 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 los Quote Tweets (“Retweets with comment”). 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 se ha hecho Retweet del Post con un comentario nuevo (mensaje). No hay Quote Tweets desde 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 marcado con like el Post. El campo public_metrics devuelve el recuento total de likes tanto de contextos orgánicos como de pago para mantener la coherencia con los recuentos mostrados públicamente en X.
Respuestasdata.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 tanto de contextos orgánicos como de pago.
Clics en enlaces URLdata.non_public_metrics.url_link_clicks, data.organic_metrics.url_link_clicks, data.promoted_metrics.url_link_clicksRecuento de cuántas veces un usuario hace clic en un enlace URL o en una tarjeta de vista previa de URL en un Post. Requiere autenticación con Contexto de usuario de OAuth 1.0a.
Clics en el perfil del usuariodata.non_public_metrics.user_profile_clicks, data.organic_metrics.user_profile_clicks, data.promoted_metrics.user_profile_clicksRecuento de cuántas veces un usuario hace clic en partes de un Post: nombre para mostrar, nombre de usuario, foto de perfil. Requiere autenticación con Contexto de usuario de OAuth 1.0a.
Reproducciones de videoincludes.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 reproducciones de video agregadas en todos los Posts en los que se ha publicado dicho video. Requiere la expansión de medios expansions=attachment.media_keys.
Cuartiles de visualización de videoincludes.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 reprodujeron cada cuartil de un video. Requiere autenticación con Contexto de usuario de OAuth 1.0a y la expansión de medios expansions=attachment.media_keys.

​
Solicitud de metrics

​
Métricas públicas

En la siguiente solicitud, pedimos las métricas públicas del Post y del video adjunto utilizando los siguientes fields y expansions. 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 fields son privados y no están disponibles para el público en X, la solicitud requiere autenticación en contexto de usuario con OAuth 2.0 o OAuth 1.0a. 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": "prueba"
  },
  "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