Sugerencias de empresas con usuarios de IG

Permite obtener datos sobre otros usuarios de IG de Instagram de empresas o creadores.

Creación

No se admite esta operación.

Lectura

GET /{ig-user-id}?fields=business_discovery.username({username})

Devuelve datos sobre otro usuario de IG de Instagram de una empresa o un creador. Realiza esta solicitud al usuario de IG de Instagram para empresas o creador que está haciendo la consulta, e identifica la empresa objetivo con el parámetro username.

Limitaciones

No se devolverán datos sobre los usuarios de IG de Instagram para empresas sujetos a restricciones por edad.

Parámetros de la cadena de consulta

{username} (obligatorio): el nombre del usuario de IG de Instagram para empresas o creador sobre el que quieres obtener datos.

Permisos

Un token de acceso de usuario de Facebook con los siguientes permisos:

instagram_basic
instagram_manage_insights
pages_read_engagement o pages_show_list

Si el token es de un usuario al que se le asignó un rol de página mediante el administrador comercial, también se requiere uno de los siguientes permisos:

ads_management
pages_read_engagement
business_management

Expansión de campos

Puedes usar la expansión de campos para obtener campos públicos en el historial del usuario de IG objetivo. Consulta la referencia del usuario de IG para obtener una lista de campos públicos.

Ejemplo de solicitud con expansión de campos

Obtener datos sobre el usuario de IG de Instagram para empresas "Blue Bottle Coffee" y utilizar la expansión de campos para indagar sobre su cantidad de seguidores y de contenido multimedia.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Ejemplo de respuesta

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Acceso a los perímetros con expansión de campos

También puedes usar la expansión de campos para acceder al perímetro /media del usuario de IG objetivo y especificar los campos y métricas que deben mostrarse para cada contenido multimedia de IG. Consulta la referencia del nodo de contenido multimedia para obtener una lista de campos públicos.

Llamadas a la versión 10.0 y anteriores hasta el 7 de septiembre de 2021: el campo like_count en un contenido multimedia de Instagram devuelve 0 si el propietario del contenido multimedia tiene ahí conteos de Me gusta ocultos.

Llamadas a la versión 11.0 y posteriores y todas las versiones desde el 7 de septiembre de 2021: si se consulta de forma indirecta un contenido multimedia de IG a través de otro punto de conexión o una expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia tiene ahí conteos de Me gusta ocultos. Solicitar de manera directa el contenido multimedia de IG (algo que solo el propietario del contenido multimedia de IG puede hacer) devolverá el conteo real de Me gusta, incluso si se ocultaron estos conteos.

Ejemplo de solicitud con el perímetro

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Ejemplo de respuesta con el perímetro

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Paginación

El perímetro /media es compatible con la paginación basada en cursores, de modo que, cuando se acceda a él mediante la expansión de campos, la respuesta incluirá los cursores before y after si esta contiene varias páginas de datos. Sin embargo, a diferencia de la paginación basada en cursores estándar, la respuesta no incluirá los campos previous ni next, de modo que deberán utilizarse los cursores before y after para construir manualmente las cadenas de consulta previous y next y poder paginar el conjunto de datos devueltos.

Ejemplo de solicitud

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Ejemplo de respuesta

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.