Descubrimiento de empresas

Puedes usar la API de Instagram con el inicio de sesión con Facebook para obtener metadatos y métricas básicos sobre otras cuentas profesionales de Instagram.

Limitaciones

No se devolverán datos sobre cuentas profesionales de Instagram con restricción de edad.

Extremos

La API consta de los extremos siguientes. Consulta los requisitos de parámetros y permisos en la documentación de referencia del extremo.

• GET /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Ejemplos

Obtener un recuento de contenido multimedia y seguidores

En esta consulta de ejemplo se muestra cómo obtener el número de seguidores y el número de objetos multimedia publicados en la cuenta profesional de Instagram Blue Bottle Coffee. Ten en cuenta que las consultas de descubrimiento de empresas se realizan en el identificador de la cuenta profesional de Instagram del usuario de la aplicación (en este caso, 17841405309211844) con el nombre de usuario de la cuenta profesional de Instagram sobre la que el usuario de la aplicación intenta obtener datos (en este ejemplo, bluebottle).

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Ejemplo de respuesta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

Obtener contenido multimedia

Como puedes hacer solicitudes anidadas especificando el perímetro mediante el parámetro fields, puedes solicitar el perímetro media de la cuenta profesional de destino para obtener todos sus objetos multimedia publicados.

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Ejemplo de respuesta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

Obtener métricas básicas sobre contenido multimedia

Puedes usar las solicitudes anidadas y la expansión de campo para obtener campos públicos de los objetos multimedia de una cuenta empresarial o de creador. Ten en cuenta que esto no te concede permiso para acceder a los objetos multimedia directamente: si realizas una acción GET en cualquier contenido multimedia de Instagram devuelto, se producirá un error porque no tendrás permisos suficientes.

Por ejemplo, esta es una forma de obtener el número de comentarios y Me gusta de cada objeto multimedia que ha publicado Blue Bottle Coffee:

Ejemplo de solicitud

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Ejemplo de respuesta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}