Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.

Actualización del documento en inglés: 14 jun. 2021

Usuario

Representa un perfil de usuario de Instagram.

Se han incorporado los identificadores de usuario específicos de la aplicación (ASID) en la versión 11.0 de la API. Puedes seguir consultando los usuarios según su identificador de usuario sin formato o su ASID equivalente. Sin embargo, las llamadas a partir de la versión 11.0 recibirán ASID como respuesta.

Los ASID reemplazarán los identificadores de usuario sin formato dentro de dos años aproximadamente, cuando se retire la versión 10.0. Por este motivo, te recomendamos que empieces a asignar los usuarios de la aplicación a sus ASID equivalentes.

Creación

Esta operación no es compatible.

Lectura

GET /{user-id}

Obtener los campos y los perímetros de un usuario.

Limitaciones

Los identificadores de usuario de la API heredados de Instagram no se admiten.

Requisitos

Tipo	Requisito
Identificadores de acceso	Usuario de Instagram
Permisos	`instagram_graph_user_profile`. El campo`media_count` también requiere `instagram_graph_user_media`.

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posición	Valor
`{api-version}` Cadena	Versión de la API.
`{user-id}` Cadena obligatoria	Identificador de usuario específico de la aplicación (a partir de la versión 11) o identificador de usuario sin formato (todas las versiones) del usuario de la aplicación.

Parámetros de la cadena de consulta

Incluye los siguientes parámetros de la cadena de la consulta para ampliar la solicitud.

Clave	Valor
`access_token` Cadena obligatoria	Identificador de acceso de usuario de Instagram del usuario de la aplicación.
`fields` Lista de valores separados por comas	Lista de valores separados por comas de los campos y perímetros que quieres que se devuelvan. Si se omite, se devolverán los campos predeterminados.

Campos

Puedes utilizar el parámetro fields de la cadena de consulta para solicitar los campos siguientes de un usuario.

Nombre del campo	Descripción
`account_type`	Tipo de cuenta del usuario. Puede ser `BUSINESS`, `MEDIA_CREATOR` o `PERSONAL`.
`id`	Identificador de usuario específico de la aplicación (a partir de la versión 11) o identificador de usuario sin formato (versión 10.0 o inferiores) del usuario de la aplicación.
`media_count`	Número de archivos multimedia del usuario. Este campo requiere el permiso `instagram_graph_user_media`.
`username`	Nombre de usuario del usuario.

Perímetros

Puedes solicitar los perímetros siguientes como parámetros de ruta o bien usar el parámetro fields de la cadena de consulta.

Perímetro	Descripción
`media`	Obtiene una lista de archivos multimedia de un usuario.

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.instagram.com/v19.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Respuesta

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Actualizar

Esta operación no es compatible.

Eliminar

Esta operación no es compatible.