Descubrimiento de empresas

Puedes usar la API Graph de Instagram para obtener metadatos y métricas básicos sobre otras cuentas empresariales y de creadores de Instagram.

Limitaciones

No se devolverán datos sobre cuentas empresariales 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 /{ig-user-id}/business_discovery

Ejemplos

Obtención de un recuento de contenido multimedia y seguidores de la cuenta

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 empresarial de Instagram Blue Bottle Coffee. Ten en cuenta que las consultas de descubrimiento de empresas se realizan en el identificador de la cuenta empresarial o de creador de Instagram (en este caso, 17841405309211844), no en el nombre de usuario de la cuenta empresarial o de creador de Instagram sobre la que intentas obtener datos (en este ejemplo, bluebottle).

Ejemplo de solicitud

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

Ejemplo de respuesta

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

Obtención de 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 empresarial o de creador de destino para obtener todos sus objetos multimedia publicados:

Ejemplo de solicitud

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={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"
}

Obtención de 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

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={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"
}