Descubrimiento de empresas de usuarios de Instagram

Te permite obtener datos sobre otros usuarios de cuentas empresariales o de creador de Instagram.

Creación

Esta operación no es compatible.

Lectura

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

Devuelve datos sobre otros usuarios de cuentas empresariales o de creador de Instagram. Realiza esta solicitud en el usuario de la cuenta empresarial o de creador de Instagram que realiza la consulta e identifica la empresa de destino con el parámetro username.

Limitaciones

No se devolverán los datos sobre los usuarios de Instagram para empresas con restricciones de edad.

Parámetros de la cadena de consulta

{username} (obligatorio): nombre del usuario de la cuenta empresarial o de creador de Instagram sobre la que quieres obtener datos.

Permisos

Identificador de acceso de un usuario de Facebook con los siguientes permisos:

instagram_basic
instagram_manage_insights
pages_read_engagement o pages_show_list

Si el identificador es de un usuario cuyo rol de página se ha concedido mediante Business Manager, también se necesita uno de los permisos siguientes:

ads_management
pages_read_engagement
business_management

Expansión de campos

Puedes usar la expansión de campos para obtener campos públicos sobre el usuario de Instagram de destino. Consulta la referencia sobre el usuario de Instagram para ver una lista de los campos públicos.

Solicitud de ejemplo con la expansión de campos

Obtención de datos sobre el usuario de Instagram para empresas "Blue Bottle Coffee" y uso de la expansión de campos para solicitar los recuentos de contenidos multimedia y seguidores.

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 la expansión de campos

También puedes usar la expansión de campos para acceder al perímetro /media del usuario de Instagram de destino y especificar los campos y los resultados que se deberían devolver para cada objeto de contenido multimedia de Instagram. Consulta la referencia del nodo de contenido multimedia para ver una lista de los campos públicos.

Llamadas de la versión 10.0 y anteriores hasta el 7 de septiembre de 2021: el campo like_count de un contenido multimedia de Instagram devolverá 0 si la persona propietaria ha ocultado el recuento de Me gusta de dicho contenido.

Llamadas de la versión 11.0 y posteriores a partir del 7 de septiembre de 2021: si consultas un contenido multimedia de Instagram indirectamente a través de otro extremo o expansión de campo, el campo like_count se omitirá de las respuestas de la API si el propietario del contenido multimedia ha ocultado su recuento de Me gusta. Al consultar directamente el contenido multimedia de Instagram (solo puede hacerlo su propietario), se devolverá el recuento real de Me gusta, aunque se haya ocultado.

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 admite la paginación basada en cursores, de modo que, cuando se use la expansión de campos para acceder a este, la respuesta incluirá los cursores before y after si 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 o next, por lo que deberás usar los cursores before y after para construir las cadenas de consulta previous y next manualmente a fin de examinar el conjunto de datos devuelto.

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

Esta operación no es compatible.

Eliminar

Esta operación no es compatible.