Contenido multimedia

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Representa una imagen, un vídeo o un álbum.

Creación

Esta operación no es compatible.

Lectura

GET /{media-id}

Obtén campos y perímetros de una imagen, un vídeo o un álbum.

Requisitos

Tipo	Requisito
Identificadores de acceso	Usuario de Instagram
Permisos	`instagram_graph_user_media`

Sintaxis de la solicitud

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

Parámetros de la cadena de consulta

Incluye los siguientes parámetros de la cadena de 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 usar el parámetro fields de la cadena de consulta para solicitar los campos siguientes de un archivo multimedia.

Nombre del campo	Descripción
`caption`	Texto del contenido multimedia. No se puede devolver para contenido multimedia en los álbumes. Nota: Cuando se usan emoticonos en los textos, el formato de codificación debe ser UTF-8 y la longitud de caracteres se puede ver afectada según el emoticono utilizado.
`id`	Identificador del contenido multimedia.
`is_shared_to_feed`	Solo para los reels. Si se define como `true`, indica que el reel puede aparecer en las pestañas Noticias y Reels. Si se define como `false`, indica que el reel solo puede aparecer en la pestaña Reels. Ninguno de los valores determina si el reel aparece realmente en la pestaña Reels, porque es posible que no cumpla con los requisitos de idoneidad o que nuestro algoritmo no lo seleccione. Consulta las especificaciones de los reels para ver los criterios de idoneidad.
`media_type`	Tipo de contenido multimedia. Puede ser `IMAGE`, `VIDEO` o `CAROUSEL_ALBUM`.
`media_url`	URL del contenido multimedia.
`permalink`	URL permanente del contenido multimedia. Se omitirá si el contenido multimedia incluye material con copyright o se ha marcado por una infracción del copyright.
`thumbnail_url`	URL de la imagen en miniatura del contenido multimedia. Solo está disponible en contenido multimedia de tipo `VIDEO`.
`timestamp`	La fecha de publicación del contenido multimedia en formato ISO 8601.
`username`	El nombre de usuario del propietario del contenido multimedia.

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
`children`	Obtén una lista del contenido multimedia del álbum. Solo está disponible en contenido multimedia de tipo `CAROUSEL_ALBUM`.

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/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

Respuesta

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

Actualización

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.