Obtener perfiles y contenido multimedia del usuario

En esta guía se expone cómo obtener el contenido multimedia y el perfil de un usuario de Instagram.

Obtener el perfil de un usuario

Sigue los pasos siguientes para obtener los datos del perfil de un usuario de Instagram (campos) del usuario.

Paso 1: Obtener el identificador de acceso y los permisos

Sigue nuestra guía para obtener identificadores de acceso y permisos y obtén el identificador de acceso de usuario de Instagram del usuario. Necesitarás el permiso instagram_graph_user_profile, por lo que deberás solicitar el ámbito user_profile cuando obtengas la autorización del usuario.

Paso 2: Consultar el nodo de usuario

Envía una solicitud al extremo siguiente:

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

Reemplaza el valor de {fields} por una lista separada por comas que incluya los campos del usuario que quieres que se devuelvan y reemplaza el valor de {access-token} por el identificador de acceso del usuario. El extremo GET /me determinará el identificador del usuario a partir del identificador y redirigirá la solicitud al nodo del usuario.

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 el contenido multimedia de un usuario

Sigue los pasos a continuación para obtener una colección de contenido multimedia de un usuario de Instagram.

Paso 1: Obtener el identificador de acceso y los permisos

Sigue nuestra guía para obtener identificadores de acceso y permisos y obtén el identificador de acceso de usuario de Instagram del usuario. Necesitarás los campos instagram_graph_user_profile y instagram_graph_user_media permissions, por lo que deberás solicitar los ámbitos user_profile y user_media cuando obtengas la autorización del usuario.

Paso 2: Consultar el perímetro de contenido multimedia del usuario

Envía una solicitud al extremo siguiente:

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

Reemplaza el valor de {fields} por una lista separada por comas con los campos de contenido multimedia que quieres que se devuelvan para cada contenido multimedia incluido en la respuesta (u omite el parámetro fields por completo si solo quieres los identificadores) y reemplaza el valor de {access-token} por el identificador de acceso del usuario. El extremo GET /me determinará el identificador del usuario a partir del identificador y redirigirá la solicitud al nodo del usuario.

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 los datos multimedia

Sigue los pasos a continuación para obtener los datos (campos) de una imagen, un vídeo o un álbum.

Paso 1: Obtener el identificador de acceso y los permisos

Sigue nuestra guía para obtener identificadores de acceso y permisos y obtén el identificador de acceso de usuario de Instagram del usuario. Necesitarás el permiso instagram_graph_user_media, por lo que deberás solicitar los ámbitos user_media cuando obtengas la autorización del usuario.

Paso 2: Consultar el nodo de contenido multimedia

Envía una solicitud al extremo siguiente:

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

Reemplaza el valor de {media-id} por el identificador de la imagen, el vídeo o el álbum que quieres consultar, reemplaza el valor de {fields} por una lista separada por comas con los campos de contenido multimedia que quieres que se devuelvan y reemplaza el valor de {access-token} por el identificador 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 (alternativo): Consultar el perímetro de contenido multimedia del usuario

Consulta el perímetro de contenido multimedia del usuario para obtener una colección de contenido multimedia del usuario y utiliza la expansión del campo para que la respuesta incluya los campos de contenido multimedia de cada contenido multimedia de la colección. Para ello, envía una consulta al extremo siguiente:

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

Reemplaza el valor de {fields} por una lista separada por comas con los campos de contenido multimedia que quieres que se devuelvan para cada contenido multimedia de la colección y reemplaza el valor de {access-token} por el identificador de acceso del usuario. El extremo GET /me determinará el identificador del usuario a partir del identificador y redirigirá la solicitud al nodo del usuario.

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 de un álbum

Sigue los pasos a continuación para obtener una colección de contenido multimedia de imagen o vídeo en contenido multimedia de un álbum.

Paso 1: Obtener el identificador de acceso y los permisos

Sigue nuestra guía para obtener identificadores de acceso y permisos y obtén el identificador de acceso de usuario de Instagram del usuario. Necesitarás el permiso instagram_graph_user_media, por lo que deberás solicitar los ámbitos user_media cuando obtengas la autorización del usuario.

Paso 2: Consultar el perímetro de contenido multimedia secundario

Envía una solicitud al extremo siguiente:

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

Reemplaza {media-id} por el identificador del álbum que quieres consultar, reemplaza {fields} por una lista separada por comas de los campos de contenido multimedia que quieres que se devuelvan para cada contenido multimedia de imagen y vídeo en la colección (u omite el parámetro fields por completo si solo quieres los identificadores) y reemplaza el valor de {access-token} por el identificador 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..."
  }
}