Consultar perfiles de usuario y contenido multimedia de usuarios

En esta guía, se explica cómo consultar un perfil de usuario de Instagram y su contenido multimedia.

Consultar un perfil de usuario

Sigue estos pasos para consultar los datos de perfil de usuario de Instagram (campos) del usuario.

Paso 1: Obtén un token de acceso y permisos

Sigue las instrucciones de la guía "Obtener tokens de acceso y permisos" para conseguir el token de acceso de Instagram del usuario. Necesitarás el permiso instagram_graph_user_profile, por lo que debes solicitar el alcance de user_profile al obtener la autorización del usuario.

Paso 2: Consulta el nodo "User"

Envía una solicitud al siguiente punto de conexión:

GET /me?fields={fields}&access_token={access-token}

Reemplaza {fields} por una lista separada por comas de los campos de usuario que deseas que se devuelvan y {access-token} por el token de acceso del usuario. El punto de conexión GET /me determina el identificador de usuario a partir del token y redirige la solicitud al nodo User.

Ejemplo de solicitud

curl -X GET \
  'https://graph.instagram.com/me?fields=id,username&access_token=IGQVJ...'

Ejemplo de respuesta

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

Obtener contenido multimedia de un usuario

Sigue estos pasos para obtener una colección de contenido multimedia de un usuario de Instagram.

Paso 1: Obtén un token de acceso y permisos

Sigue las instrucciones de la guía "Obtener tokens de acceso y permisos" para conseguir el token de acceso de Instagram del usuario. Necesitarás instagram_graph_user_profile y instagram_graph_user_media permissions, por lo que debes solicitar los alcances de user_profile y user_media al obtener la autorización del usuario.

Paso 2: Consulta el perímetro del contenido multimedia del usuario

Envía una solicitud al siguiente punto de conexión:

GET /me/media?fields={fields}&access_token={access-token}

Reemplaza {fields} por una lista separada por comas de los campos de contenido multimedia que deseas que se devuelvan por cada elemento de contenido multimedia incluido en la respuesta (o bien omite el parámetro fields por completo si solo deseas recibir los identificadores) y reemplaza {access-token} por el token de acceso del usuario. El punto de conexión GET /me determina el identificador de usuario a partir del token y redirige la solicitud al nodo User.

Ejemplo de solicitud

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Ejemplo de respuesta

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Obtener datos del contenido multimedia

Sigue estos pasos para obtener los datos (campos) de una imagen, un video o un álbum.

Paso 1: Obtén un token de acceso y permisos

Sigue las instrucciones de la guía "Obtener tokens de acceso y permisos" para conseguir el token de acceso de Instagram del usuario. Necesitarás el permiso instagram_graph_user_media, por lo que debes solicitar el alcance de user_media al obtener la autorización del usuario.

Paso 2: Consulta el nodo "Media"

Envía una solicitud al siguiente punto de conexión:

GET /{media-id}?fields={fields}&access_token={access-token}

Reemplaza {media-id} por el identificador de la imagen, el video o el álbum que deseas consultar; {fields} por una lista separada por comas de los campos de contenido multimedia que deseas que se devuelvan; y {access-token} por el token de acceso del usuario.

Ejemplo de solicitud

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Ejemplo de respuesta

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Paso 2 (alternativa): Consulta el perímetro del contenido multimedia del usuario

Puedes consultar el perímetro del contenido multimedia del usuario para recibir una colección de elementos de contenido multimedia del usuario y usar la expansión de campos para que esta respuesta incluya campos de contenido multimedia de cada elemento de contenido multimedia de la colección. Para hacerlo, envía una solicitud al siguiente punto de conexión:

GET /me/media?fields={fields}&access_token={access-token}

Reemplaza {fields} por una lista separada por comas de los campos de contenido multimedia que deseas que se devuelvan por cada elemento de contenido multimedia de la colección y reemplaza {access-token} por el token de acceso del usuario. El punto de conexión GET /me determina el identificador de usuario a partir del token y redirige la solicitud al nodo User.

Ejemplo de solicitud

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

Ejemplo de respuesta

{
  "data": [
    {
      "id": "17895695668004550",
      "caption": ""
    },
    {
      "id": "17899305451014820",
      "caption": ""
    },
    {
      "id": "17896450804038745",
      "caption": ""
    },
    {
      "id": "17881042411086627",
      "caption": ""
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

Obtener contenido del álbum

Sigue estos pasos para obtener una colección de contenido multimedia de imágenes y videos de un contenido multimedia que es un álbum.

Paso 1: Obtén un token de acceso y permisos

Sigue las instrucciones de la guía "Obtener tokens de acceso y permisos" para conseguir el token de acceso de Instagram del usuario. Necesitarás el permiso instagram_graph_user_media, por lo que debes solicitar el alcance de user_media al obtener la autorización del usuario.

Paso 2: Consulta el perímetro secundario del contenido multimedia

Envía una solicitud al siguiente punto de conexión:

GET /{media-id}/children?fields={fields}&access_token={access-token}

Reemplaza {media-id} por el identificador del álbum que deseas consultar; {fields} por una lista separada por comas de los campos de contenido multimedia que deseas recibir por cada elemento de contenido multimedia que sea una imagen o un video que esté incluido en la colección (o bien omite el parámetro fields por completo si solo deseas recibir los identificadores); y {access-token} por el token de acceso del usuario.

Ejemplo de solicitud

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

Ejemplo de respuesta

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}