Plataforma de Instagram

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

TipoRequisito

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ónValor

{api-version}
Cadena

Versión de la API.

{user-id}
Obligatorio
Cadena

Identificador de usuario específico de la app (versión 11.0 o posterior) o identificador de usuario sin procesar (todas las versiones).

Parámetros de la cadena de consulta

Incluye los siguientes parámetros en la cadena de consulta para hacer una solicitud más compleja.

ClaveValor

access_token
Cadenaobligatoria

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 campoDescripció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ímetroDescripció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/v21.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Respuesta

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

Actualización

No se admite esta operación.

Eliminación

No se admite esta operación.