Se actualizó este documento.
La traducción en español no está disponible todavía.

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

Usuario

Representa un perfil de usuario de Instagram.

La versión 11.0 de la API introdujo los identificadores de usuario específico de la app (ASID). Puedes continuar consultando los usuarios con sus identificadores de usuario sin procesar; sin embargo, las llamadas de la versión 11.0 y posteriores recibirán los ASID como respuesta.

Los ASID reemplazarán a los identificadores de usuario sin procesar en unos dos años, cuando la versión 10.0 quede obsoleta. Por este motivo, te recomendamos que empieces a asignar los usuarios de la app a sus equivalentes ASID.

Creación

No se admite esta operación.

Lectura

GET /{user-id}

Se usa para obtener campos y perímetros de un usuario.

Limitaciones

No se admiten los identificadores de usuario heredados de la API de Instagram.

Requisitos

Tipo	Requisito
Tokens 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}` Obligatorio Cadena	Identificadores de usuario específicos de la app de los usuarios de la app (versión 11.0 o posterior) o identificador de usuario sin procesar (todas las versiones).

Parámetros de cadena de la consulta

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

Clave	Valor
`access_token` Cadena obligatoria	Token de acceso de usuario de Instagram del usuario de la app.
`fields` Lista separada por comas	Lista separada por comas de los campos y los perímetros que quieres obtener. Si se omite, recibirás los campos predeterminados.

Campos

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

Nombre del campo	Descripción
`account_type`	Tipo de cuenta del usuario. Puede ser `BUSINESS`, `MEDIA_CREATOR` o `PERSONAL`.
`id`	Identificadores de usuario específicos de la app de los usuarios de la app (versión 11.0 o posterior) o identificador de usuario sin procesar (versión 10.0 o anterior).
`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 siguientes perímetros como parámetros de ruta o mediante el parámetro de cadena de consulta fields.

Perímetro	Descripción
`media`	Se usa para obtener una lista de los archivos multimedia del usuario.

Respuesta

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

{
  "{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"
}

Actualización

No se admite esta operación.

Eliminar

No se admite esta operación.