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.

Muestra una imagen, un video o un álbum.

Creación

No se admite esta operación.

Lectura

GET /{media-id}

Se usa para obtener campos y perímetros de una imagen, un video o un álbum.

Requisitos

Tipo	Requisito
Tokens 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 en la cadena de consulta para hacer una solicitud más compleja.

Clave	Valor
`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 contenido multimedia.

Nombre del campo	Descripción
`caption`	Texto de la leyenda del contenido multimedia. No se puede devolver en el caso de contenido multimedia de álbumes. Nota: Cuando uses emojis en subtítulos, el formato de codificación deberá ser UTF-8, y la cantidad de caracteres puede verse afectada según el emoji que utilices.
`id`	Identificador del contenido multimedia.
`is_shared_to_feed`	Solo para Reels. Si el valor es `true`, indica que el reel puede aparecer en las pestañas Feed y Reels. Si el valor es `false`, indica que el reel solo puede aparecer en la pestaña Reels. Ningún valor determina si el reel aparece realmente en la pestaña Reels porque es posible que no cumpla con los requisitos o que no lo haya seleccionado nuestro algoritmo. Consulta las especificaciones de reels para conocer los criterios de elegibilidad.
`media_type`	Tipo de contenido multimedia. Puede ser `IMAGE`, `VIDEO` o `CAROUSEL_ALBUM`.
`media_url`	URL del contenido multimedia.
`permalink`	URL permanente el contenido multimedia. Se omitirá si el contenido multimedia incluye material protegido por derechos de autor o si se marcó debido a una infracción de derechos de autor.
`thumbnail_url`	URL de la imagen en miniatura del contenido multimedia. Solo disponible con el contenido multimedia `VIDEO`.
`timestamp`	Fecha de publicación del contenido multimedia en formato ISO 8601.
`username`	Nombre de usuario del propietario del contenido multimedia.

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
`children`	Obtiene una lista del contenido multimedia en el álbum de contenido multimedia. Solo disponible con el contenido multimedia `CAROUSEL_ALBUM`.

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/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

No se admite esta operación.

Eliminación

No se admite esta operación.