Estadísticas de usuario de Instagram

Representa la métrica de la interacción social en relación con un usuario de Instagram.

Creación

No se admite esta operación.

Lectura

GET /{ig-user-id}/insights

Devuelve estadísticas sobre un usuario de IG.

Limitaciones

• follower_count, online_followers y todas las métricas de audience_* no están disponibles para usuarios de IG con menos de 100 seguidores.
• Los datos estadísticos de la métrica online_followers solo están disponibles para los últimos 30 días.
• Si los datos estadísticos que solicitas no existen o no están disponibles en el momento, la API devolverá un conjunto de datos vacíos en lugar de 0 para las métricas individuales.
• Las métricas demográficas solo devuelven los 45 mejores resultados (por ejemplo, para audience_city, se pueden devolver hasta 45 ciudades con el mayor número de seguidores).
• En los cálculos de las métricas demográficas, solo se usan los espectadores cuyos datos demográficos tenemos a disposición.
• Si se suman los valores de las métricas demográficas, se puede obtener un valor inferior al recuento de seguidores (ver viñeta anterior).
• audience_*Las métricas no son compatibles con los parámetros de intervalosince ni until.
• Los datos que se usan para calcular las métricas pueden ser de hasta 48 horas antes.

Requisitos

Sintaxis de la solicitud

GET https://graph.facebook.com/{api-version}/{ig-user-id}/insights
  ?metric={metric}
  &period={period}
  &since={since}
  &until={until}
  &access_token={access-token}

Parámetros de ruta

Parámetros de la cadena de consulta

Métricas y períodos

Las métricas que son compatibles con los períodos lifetime recibirán los resultados en una matriz de períodos de 24 horas, con períodos que terminan en UTC−07:00. Las métricas audience_* no admiten los parámetros de intervalosince ni until.

Intervalo

Este perímetro es compatible con la paginación basada en el tiempo, por lo que puede incluir los parámetros since y until con marcas de tiempo UNIX para definir un intervalo. Por ejemplo, para obtener el valor de 28 días de impresiones (todos los días durante los últimos 10 días), se podrían generar marcas de tiempo UNIX de los últimos 10 días y del día en curso, asignarlas a los parámetros since y until, e incluirlas en la solicitud:

metric=impressions&period=days_28&since=1501545600&until=1502493720

Los parámetros since y until son inclusivos, por lo que si el intervalo incluye un día que no ha terminado (es decir, el día en curso), las consultas posteriores a lo largo del día pueden devolver valores aumentados. Si no se incluyen los parámetros since y until, la API tendrá un intervalo de 2 días de forma predeterminada: de ayer a hoy.

Ejemplo de solicitud

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914/insights?metric=impressions,reach,profile_views&period=day&access_token=IGQVJ...'

Ejemplo de respuesta

{
  "data": [
    {
      "name": "impressions",
      "period": "day",
      "values": [
        {
          "value": 4,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 66,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Impressions",
      "description": "Total number of times this profile has been seen",
      "id": "17841400008460056/insights/impressions/day"
    },
    {
      "name": "reach",
      "period": "day",
      "values": [
        {
          "value": 3,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 36,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Reach",
      "description": "Total number of unique accounts that have seen this profile",
      "id": "17841400008460056/insights/reach/day"
    },
    {
      "name": "profile_views",
      "period": "day",
      "values": [
        {
          "value": 0,
          "end_time": "2017-05-04T07:00:00+0000"
        },
        {
          "value": 2,
          "end_time": "2017-05-05T07:00:00+0000"
        }
      ],
      "title": "Profile Views",
      "description": "Total number of unique accounts that have viewed this profile within the specified period",
      "id": "17841400008460056/insights/profile_views/day"
    }
  ]
}

Observa que el ejemplo de solicitud indicado no incluía los parámetros since y until, por lo que la API devolvió los datos correspondientes a un intervalo predeterminado de 2 días. Cada día se identifica por una marca de tiempo UTC con formato ISO 8601 y con un desfase de cero, que se asignó a una propiedad end_time.

La propiedad end_time indica una fecha de corte de un conjunto de datos; los datos más antiguos que este valor no se incluyen en el cálculo del conjunto de datos.

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.

Nuevas métricas

Sintaxis de la solicitud

GET https://graph.facebook.com/{api-version}/{ig-user-id}/insights
  ?metric={metric}
  &period={period}
  &timeframe={timeframe}
  &metric_type={metric-type}
  &breakdown={breakdown}
  &since={since}
  &until={until}
  &access_token={access-token}

Parámetros de ruta

Parámetros de la cadena de consulta

Desglose

Si solicitas metric_type=total_value, también puede especificar uno o más desgloses y los resultados se desglosarán en conjuntos más pequeños que se basan en el desglose especificado. Los valores pueden ser los siguientes:

• contact_button_type: desglosa los resultados según el componente de UI de los perfiles que los espectadores tocan o en el que hacen clic. Los valores de la respuesta pueden ser los siguientes:

  • BOOK_NOW
  • CALL
  • DIRECTION
  • EMAIL
  • INSTANT_EXPERIENCE
  • TEXT
  • UNDEFINED
• follow_type: desglosa los resultados por seguidores y no seguidores. Los valores de la respuesta pueden ser los siguientes:

  • FOLLOWER
  • NON_FOLLOWER
  • UNKNOWN
• media_product_type: desglosa los resultados según la superficie en las que los espectadores vieron el contenido multimedia del usuario de la app o interactuaron con dicho contenido. Los valores de la respuesta pueden ser los siguientes:

  • AD
  • FEED
  • REELS
  • STORY

Consulta la tabla Métricas para determinar cuáles son compatibles con un desglose. Si solicitas una métrica que no admite desgloses, la API devolverá un error (""An unknown error has occurred.""). Por este motivo, ten cuidado si solicitas varias métricas en una sola consulta.

Si solicitas metric_type=time_series, los desgloses no se incluirán en la respuesta.

Tipo de métricas

Puedes indicar cómo quiere que se agreguen los resultados, ya sea por período o como total simple (con desgloses, si así se lo solicita). Los valores pueden ser los siguientes:

• time_series: indica a la API que agregue los resultados por período. Consulta Período.
• total_value: indica a la API que devuelva los resultados como total simple. Si se incluyen desgloses en la solicitud, el conjunto de resultados se desglosará aún más según desgloses específicos. Consulta Desglose.

Período

Indica a la API cuál es el intervalo de tiempo que se debe usar al agregar resultado. Es solo compatible con las métricas relacionadas con la interacción.

Plazo

Indica a la API hasta dónde buscar en el pasado para obtener datos cuando se solicitan métricas relacionadas con la demografía. Este valor reemplaza los parámetros since y until.

Intervalo

Asigna marcas de tiempo UNIX a los parámetros since y until para definir un intervalo. La API solo incluirá datos creados dentro de este intervalo (inclusivo). Si no incluyes estos parámetros, la API solo consultará 24 horas atrás.

Si se consultan métricas relacionadas con la demografía, el parámetro timeframe reemplaza estos valores. Consulta Plazo.

Métricas

Métricas de interacción

Métricas demográficas

Respuesta

Un objeto JSON que contiene los resultados de tu consulta. Los resultados pueden incluir los siguientes datos, según lo que se especificó en la consulta:

{
  "data": [
    {
      "name": "{data}",
      "period": "{period}",
      "title": "{title}",
      "description": "{description}",
      "total_value": {
        "value": {value},
        "breakdowns": [
          {
            "dimension_keys": [
              "{key-1}",
              "{key-2",
              ...
            ],
            "results": [
              {
                "dimension_values": [
                  "{value-1}",
                  "{value-2}",
                  ...
                ],
                "value": {value},
                "end_time": "{end-time}"
              },
              ...
            ]
          }
        ]
      },
      "id": "{id}"
    }
  ],
  "paging": {
    "previous": "{previous}",
    "next": "{next}"
  }
}

Contenido de la respuesta

Ejemplo de solicitud de métricas de interacción

curl -i -X GET \
  "https://graph.facebook.com/v19.0/17841405822304914/insights?metric=reach&period=day&breakdown=media_product_type&metric_type=total_value&since=1658991600&access_token=EAAOc..."

Ejemplo de respuesta de métricas de interacción

{
  "data": [
    {
      "name": "reach",
      "period": "day",
      "title": "Accounts reached",
      "description": "The number of unique accounts that have seen your content, at least once, including in ads. Content includes posts, stories, reels, videos and live videos. Reach is different from impressions, which may include multiple views of your content by the same accounts. This metric is estimated and in development.",
      "total_value": {
        "value": 224,
        "breakdowns": [
          {
            "dimension_keys": [
              "media_product_type"
            ],
            "results": [
              {
                "dimension_values": [
                  "CAROUSEL_CONTAINER"
                ],
                "value": 100
              },
              {
                "dimension_values": [
                  "POST"
                ],
                "value": 124
              }
            ]
          }
        ]
      },
      "id": "17841405309211844/insights/reach/day"
    }
  ],
  "paging": {
    "previous": "https://graph.face...",
    "next": "https://graph.face..."
  }

Ejemplo de solicitud de métricas demográficas

curl -i -X GET \
  "https://graph.facebook.com/v19.0/17841405822304914/insights?metric=engaged_audience_demographics&period=lifetime&timeframe=last_90_days&breakdowns=country&metric_type=total_value&access_token=EAAOc..."

Ejemplo de respuesta de métricas demográficas

{
  "data": [
    {
      "name": "engaged_audience_demographics",
      "period": "lifetime",
      "title": "Engaged audience demographics",
      "description": "The demographic characteristics of the engaged audience, including countries, cities and gender distribution.",
      "total_value": {
        "breakdowns": [
          {
            "dimension_keys": [
              "timeframe",
              "country"
            ],
            "results": [
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "AR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "RU"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "MA"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "LA"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "IQ"
                ],
                "value": 2
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "MX"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "FR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "ES"
                ],
                "value": 3
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "NL"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "TR"
                ],
                "value": 1
              },
              {
                "dimension_values": [
                  "LAST_90_DAYS",
                  "US"
                ],
                "value": 7
              }
            ]
          }
        ]
      },
      "id": "17841401130346306/insights/engaged_audience_demographics/lifetime"
    }
  ]
}