Usuario de Instagram

Representa una cuenta empresarial de Instagram o una cuenta de creador de Instagram.

Creación

Esta operación no es compatible.

Lectura

GET /{ig-user-id}

Obtén campos y perímetros en una cuenta empresarial o de creador de Instagram.

Requisitos

Tipo	Descripción
Identificadores de acceso	Usuario.
Roles de la empresa	Si vas a solicitar el campo `shopping_product_tag_eligibility` para el etiquetado de productos, el usuario de la aplicación debe tener un rol de administrador en la cuenta de Business Manager a la que pertenece la tienda de Instagram del usuario de Instagram.
Tienda de Instagram	Si vas a solicitar el campo `shopping_product_tag_eligibility` para el etiquetado de productos, el usuario de Instagram debe tener una tienda de Instagram aprobada con un catálogo de productos que contenga productos.
Permisos	`instagram_basic` `pages_read_engagement` `pages_show_list` Si se ha concedido un rol en la página al usuario de la aplicación mediante Business Manager, también necesitas uno de los permisos siguientes: `ads_management` `business_management` Si vas a solicitar el campo `shopping_product_tag_eligibility` para el etiquetado de productos, también necesitarás lo siguiente: `catalog_management` `instagram_shopping_tag_products`

Sintaxis de la solicitud

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

Parámetros de ruta

Marcador de posición	Valor
`{api-version}`	Versión de la API.
`{ig-user-id}`	Obligatorio. Identificador del usuario de Instagram.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`{access-token}`	Obligatorio. Identificador de acceso del usuario de la aplicación.
`fields`	`{fields}`	Lista separada por comas de los campos de usuario de Instagram que quieres que se devuelvan para cada usuario de Instagram en el conjunto de resultados.

Campos

Un perímetro puede devolver los campos públicos mediante la expansión de campos.

Nombre del campo	Descripción
`biography` Público	Texto de la biografía del perfil.
`id` Público	Identificador de usuario específico de la aplicación.
`ig_id`	Identificador de usuario de Instagram. Se usa con la API de Instagram heredada, que se ha retirado. En su lugar, puedes utilizar `id`.
`followers_count` Público	Número total de usuarios de Instagram que siguen al usuario.
`follows_count`	Número total de usuarios de Instagram a los que sigue el usuario.
`media_count` Público	Número total de objetos de contenido multimedia de Instagram publicados en el usuario.
`name`	Nombre del perfil.
`profile_picture_url`	URL de la foto del perfil.
`shopping_product_tag_eligibility`	Devuelve `true` si el usuario de la aplicación ha configurado una tienda de Instagram y, por lo tanto, es apto para el etiquetado de productos; en caso contrario, devuelve `false`.
`username` Público	Nombre de usuario del perfil.
`website` Público	URL del sitio web de perfil único.

Perímetros

Perímetro	Descripción
`business_discovery`	Obtén datos sobre otros usuarios de Instagram de cuentas empresariales o de creador de Instagram.
`content_publishing_limit`	Representa el uso actual de publicación de contenido de un usuario de Instagram.
`insights`	Representa los resultados de interacción social de un usuario de Instagram.
`live_media`	Representa una colección de contenido multimedia de Instagram de vídeo en directo de un usuario de Instagram.
`media`	Representa una colección de contenido multimedia de Instagram de un usuario de Instagram.
`media_publish`	Publica un contenedor de Instagram en un usuario de Instagram para empresas.
`mentions`	Crea un comentario de Instagram en un comentario de Instagram o contenido multimedia de Instagram con texto en que un usuario de Instagram haya sido @mencionado por otro.
`mentioned_comment`	Obtén datos sobre un comentario de Instagram en el que un usuario de Instagram haya sido @mencionado por otro.
`mentioned_media`	Obtén datos sobre un objeto de contenido multimedia de Instagram en el que un usuario de Instagram haya sido @mencionado por otro en un texto.
`recently_searched_hashtags`	Obtén los hashtags de Instagram que ha buscado un usuario de Instagram durante los últimos 7 días.
`stories`	Representa una colección de los objetos de contenido multimedia de Instagram de historias de un usuario de Instagram.
`tags`	Representa una colección de contenido multimedia de Instagram en el que un usuario de Instagram ha sido etiquetado por otro.

Respuesta

Objeto con formato JSON que contiene los campos y los perímetros solicitados y predeterminados.

{
  "{field}":"{value}",
  ...
}

Ejemplo de cURL

Solicitud

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Respuesta

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Actualizar

Esta operación no es compatible.

Eliminar

Esta operación no es compatible.