Contenido multimedia de Instagram

Representa un álbum, una foto o un vídeo (subido, en directo, reel o historia) de Instagram.

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

Se ha introducido el campo siguiente:

legacy_instagram_media_id

Los siguientes campos de los extremos de anuncios de Instagram de la API de marketing no se admiten:

filter_name
location
location_name
latitude
longitude

Creación

Esta operación no es compatible.

Lectura

GET /<IG_MEDIA_ID>

Obtiene los campos y perímetros del contenido multimedia de Instagram.

Requisitos

	API de Instagram con el inicio de sesión con Instagram	API de Instagram con el inicio de sesión con Facebook
Identificadores de acceso	Identificador de acceso de usuario de Instagram	Identificador de acceso de usuario de Facebook
Dirección URL del host	`graph.instagram.com`	`graph.facebook.com`
Tipo de inicio de sesión	Inicio de sesión empresarial para Instagram	Inicio de sesión con Facebook para empresas
Permisos	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` Si se ha concedido un rol al usuario de la aplicación mediante Business Manager en la página conectada a la cuenta profesional de Instagram del usuario de la aplicación, tu aplicación también necesitará uno de los permisos siguientes: `ads_management` `ads_read`

Limitaciones

Campos como comments_count y like_count devuelven la interacción del contenido multimedia de Instagram de destino y no incluyen datos de otras plataformas. Por ejemplo, comments_count devuelve el número de comentarios de una foto, pero no los de los anuncios que la incluyen. Usa total_comments_count y total_like_count para obtener recuentos agregados que incluyan las interacciones del contenido multimedia promocionado o publicitario. Se puede incluir el recuento de publicaciones cruzadas de una publicación de Facebook si el usuario de la sesión puede acceder a dicha publicación.
Los textos no incluyen el símbolo @ a menos que el usuario de la aplicación también pueda realizar tareas de administración equivalentes en la aplicación.
Algunos campos, como permalink, no se pueden utilizar en fotos de álbumes (elementos dependientes).
El contenido multimedia de Instagram de vídeo en directo solo se puede leer mientras se transmite.
Esta API solo devuelve datos de contenido multimedia que sean propiedad de cuentas profesionales de Instagram. No se puede usar para obtener datos de contenido multimedia que sean propiedad de cuentas personales de Instagram.
Los campos reposts_count, saved_count, shares_count, total_like_count, total_comments_count y total_views_count no están disponibles para el contenido multimedia dependiente de secuencia y solo se devuelven para los objetos multimedia de nivel superior. El propietario del contenido multimedia puede desactivar la visualización de los Me gusta, los comentarios, las visualizaciones, las republicaciones y las veces que se ha compartido. En estos casos, no se devuelven los campos correspondientes.

Sintaxis de la solicitud

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Parámetros de ruta

Marcador de posición	Valor
`<API_VERSION>` La versión más reciente es: `v26.0`	Versión de la API que está utilizando tu aplicación. Si no se especifica en las llamadas a la API, será la versión más reciente en el momento de la creación de tu aplicación de Meta o, si dicha versión ya no está disponible, la versión más antigua disponible. Obtén más información sobre el control de versiones.
`<HOST_URL>`	La dirección URL del host que está usando tu aplicación para consultar el extremo.
`<IG_MEDIA_ID>`	Obligatorio. Identificador del contenido multimedia que se va a publicar.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`<ACCESS_TOKEN>`	Obligatorio. El identificador de acceso de usuario de Instagram o Facebook del usuario de la aplicación.
`fields`	`<LIST_OF_FIELDS>`	Lista separada por comas de los campos que quieres que se devuelvan.

Campos

Campos públicos que se pueden leer mediante la expansión de campos.

Campo Descripción

alt_text Público

Texto descriptivo de las imágenes, con fines de accesibilidad.

boost_ads_list

Ofrece un resumen de toda la información de los anuncios de Instagram que está asociada al contenido multimedia orgánico de los anuncios con el estado ACTIVE. Incluye el identificador del anuncio relativo y el estado de la entrega del anuncio. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

boost_eligibility_info

El campo proporciona información sobre cómo promocionar la idoneidad de un contenido multimedia de Instagram como anuncio y detalles adicionales si no es idóneo. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

caption Público

Texto. Excluye los elementos dependientes del álbum. Se excluye el símbolo @ a menos que el usuario de la aplicación pueda realizar tareas de administración equivalentes en la página de Facebook conectada a la cuenta de Instagram utilizada para crear el texto. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

comments_count Público

Recuento de comentarios del contenido multimedia. Excluye los comentarios del contenido multimedia de los elementos dependientes del álbum, así como el texto de dicho contenido. Incluye las respuestas a los comentarios.

copyright_check_information.status

Devuelve los objetos status y matches_found.

Objetos “status” Descripción

status

completed: el proceso de detección ha finalizado.
error: se ha producido un error durante el proceso de detección.
in_progress: el proceso de detección está en curso.
not_started: el proceso de detección no ha empezado.

matches_found

Establece el objeto en uno de los siguientes valores:

false si el vídeo no infringe los derechos de autor.
true si el vídeo infringe los derechos de autor.

Si un vídeo infringe los derechos de autor, se devuelve copyright_matches con una matriz de objetos sobre el material con derechos de autor, el momento en que se produce la infracción en el vídeo y las acciones que se deben tomar para mitigar la infracción.

Objetos “copyright_matches”	Descripción
`author`	Autor del vídeo con derechos de autor.
`content_title`	Nombre del vídeo con derechos de autor.
`matched_segments`	Matriz de objetos con los siguientes pares de clave-valor: `duration_in_seconds`: número de segundos durante los que el contenido infringe los derechos de autor. `segment_type`: `AUDIO` o `VIDEO`. `start_time_in_seconds`: establécelo en la hora de inicio del vídeo.
`owner_copyright_policy`	Entre los objetos devueltos se incluyen los siguientes: `name`: nombre de la política de los propietarios de los derechos de autor. `actions`: matriz de objetos `action` con los pasos de mitigación seguidos según se definen en la política del propietario de los derechos de autor. Se pueden incluir diferentes pasos de mitigación para diferentes ubicaciones. `action`: acción de mitigación llevada a cabo en relación con la infracción de los derechos de autor del vídeo. Se pueden seguir diferentes pasos de mitigación para diferentes países. Puede ser uno de los siguientes valores: `BLOCK`: el vídeo se ha bloqueado para las audiencias que se indican en la matriz `geos`. `MUTE`: el vídeo se ha silenciado para las audiencias que se indican en la matriz `geos`.

id Público

Identificador del contenido multimedia.

is_ai_generated

Indica si el contenido multimedia tiene una etiqueta de IA. Excluye los elementos dependientes del álbum.

is_comment_enabled

Indica si los comentarios están activados o desactivados. Excluye los elementos dependientes del álbum.

is_shared_to_feed Público

Solo para Reels. Si se define como true, indica que el reel puede aparecer en las pestañas Feed 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.

legacy_instagram_media_id

Identificador del archivo multimedia de Instagram que se creó para los extremos de la API de marketing en la versión 21.0 y versiones posteriores.

like_count

Recuento de Me gusta del contenido multimedia, incluidas las respuestas a los comentarios. Excluye los Me gusta del contenido multimedia del elemento dependiente del álbum y los de las publicaciones promocionadas creadas a partir del contenido multimedia.

Si se consulta indirectamente mediante otro extremo o la expansión de campos, el campo like_count se omite si el propietario del contenido multimedia ha ocultado los recuentos de Me gusta.

media_audio_type Público

Tipo de audio que se usa en el contenido multimedia. Puede ser MUSIC o ORIGINAL_SOUND. Solo se devuelve en el caso del contenido multimedia de vídeo, como los reels; no se devuelve para otros tipos de contenido multimedia (por ejemplo, fotos y secuencias).

media_product_type Público

Superficie en la que se publica el contenido multimedia. Puede ser AD, FEED, STORY o REELS. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

media_type Público

Tipo de contenido multimedia. Puede ser CAROUSEL_ALBUM, IMAGE o VIDEO.

media_url Público

URL del contenido multimedia.

El campo media_url se omite de las respuestas si el contenido multimedia incluye material con copyright o se ha marcado por una infracción del copyright. Entre los ejemplos de material con copyright, se puede encontrar el audio de los reels.

owner Público

Identificador del usuario de Instagram que creó el contenido multimedia. Solo se devuelve si el usuario de la aplicación que realiza la consulta también creó el contenido multimedia. En caso contrario, se devuelve el campo username.

permalink Público

URL permanente del contenido multimedia.

shortcode Público

Código corto del contenido multimedia.

thumbnail_url Público

URL de la miniatura del contenido multimedia. Solo está disponible en contenido multimedia de tipo VIDEO.

timestamp Público

Fecha de creación en formato ISO 8601 en UTC (el valor predeterminado es UTC ±00:00).

username Público

Nombre del usuario que creó el contenido multimedia.

view_count Público

Recuento de reproducciones de reels de Instagram, que incluye métricas orgánicas y de pago. En el caso del contenido que se ha utilizado en una publicación cruzada en Facebook, devuelve el recuento combinado de visualizaciones de Instagram y Facebook si el usuario de la sesión puede acceder a la publicación de Facebook.

Solo está disponible para la API de descubrimiento de empresas.

reposts_count Público

Número de veces que se ha republicado el contenido multimedia. Disponible para el contenido multimedia de FEED y REELS. No se pueden acceder a ellos mediante los extremos de la API de hashtags. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

saved_count

Cantidad de veces que se ha guardado el contenido multimedia. Disponible para el contenido multimedia de FEED y REELS. Solo puede acceder a ellos el propietario del contenido multimedia o un colaborador aceptado. No se puede acceder mediante el descubrimiento de empresas, el contenido multimedia etiquetado o mencionado ni los extremos de la API de hashtags. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

shares_count

Cantidad de veces que se ha compartido el contenido multimedia. Disponible para el contenido multimedia de FEED y REELS. No se puede acceder mediante los extremos de la API de hashtags o de descubrimiento de empresas. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

total_comments_count Público

Número total de comentarios del contenido multimedia en todas las plataformas, incluidos los comentarios del contenido multimedia promocionado. No se pueden acceder a ellos mediante los extremos de la API de hashtags. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

total_like_count Público

Número total de Me gusta del contenido multimedia en todas las plataformas, incluidos los Me gusta del contenido multimedia promocionado. No se pueden acceder a ellos mediante los extremos de la API de hashtags. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

total_views_count

Recuento total de visualizaciones de contenido de vídeo en todas las plataformas, incluidas las visualizaciones de contenido multimedia promocionado o patrocinado y las visualizaciones sucesivas. Solo está disponible para el contenido multimedia de vídeo. No se puede acceder mediante los extremos de la API de hashtags o de descubrimiento de empresas. En el caso de la API de descubrimiento de empresas, usa view_count en su lugar. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

Perímetros

Perímetros públicos que se pueden devolver mediante la expansión de campos.

Perímetro	Descripción
`children` Público.	Representa una colección de los objetos de contenido multimedia de Instagram del contenido multimedia de Instagram de un álbum.
`collaborators`	Representa una lista de los usuarios que se añaden como colaboradores en un objeto de contenido multimedia de Instagram. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.
`comments`	Representa una colección de comentarios de Instagram en un objeto de contenido multimedia de Instagram.
`insights`	Representa las métricas de interacción social de un objeto de contenido multimedia de Instagram.

Ejemplo de cURL

Ejemplo de solicitud

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

Ejemplo de respuesta

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Actualización

POST /<IG_MEDIA_ID>

Activa o desactiva los comentarios en un objeto de contenido multimedia de Instagram.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic` `instagram_business_manage_comments`	`instagram_basic` `instagram_manage_comments` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read`

Limitaciones

No se admite el contenido multimedia de Instagram de vídeo en directo.

Sintaxis de la solicitud

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Parámetros de ruta

Marcador de posición	Valor
`<API_VERSION>` La versión más reciente es: `v26.0`	Versión de la API que está utilizando tu aplicación. Si no se especifica en las llamadas a la API, será la versión más reciente en el momento de la creación de tu aplicación de Meta o, si dicha versión ya no está disponible, la versión más antigua disponible. Obtén más información sobre el control de versiones.
`<HOST_URL>`	La dirección URL del host que está usando tu aplicación para consultar el extremo.
`<IG_MEDIA_ID>`	Obligatorio. Identificador del contenido multimedia que se va a publicar.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`<ACCESS_TOKEN>`	Obligatorio.Identificador de acceso del usuario de la aplicación.
`comment_enabled`	`<BOOL>`	Obligatorio. Se define como `true` para activar los comentarios o como `false` para desactivarlos.

Ejemplo de cURL

Ejemplo de solicitud

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Ejemplo de respuesta

{
  "success": true
}

Eliminación

DELETE /<IG_MEDIA_ID>

Elimina el contenido multimedia de Instagram.

Requisitos

	API de Instagram con el inicio de sesión con Facebook
Identificadores de acceso	Identificador de acceso de usuario de Facebook
Dirección URL del host	`graph.facebook.com`
Tipo de inicio de sesión	Inicio de sesión con Facebook para empresas
Permisos	`instagram_basic` `instagram_manage_contents`

Limitaciones

Esta API solo admite la API de Instagram con el inicio de sesión con Facebook. Se admiten los reels, las historias y las publicaciones que no sean de anuncios, así como los álbumes de secuencia completos. Para eliminar contenido multimedia de un álbum de secuencia, debes eliminar todo el álbum. Para ello, especifica el identificador de contenido multimedia del contenedor de la secuencia. No se puede eliminar contenido multimedia de una secuencia de forma individual.

Sintaxis de la solicitud

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Parámetros de ruta

Marcador de posición	Valor
`<API_VERSION>` La versión más reciente es: `v26.0`	Versión de la API que está utilizando tu aplicación. Si no se especifica en las llamadas a la API, será la versión más reciente en el momento de la creación de tu aplicación de Meta o, si dicha versión ya no está disponible, la versión más antigua disponible. Obtén más información sobre el control de versiones.
`<IG_MEDIA_ID>`	Obligatorio. Identificador del contenido multimedia que se va a publicar.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`<ACCESS_TOKEN>`	Obligatorio.Identificador de acceso del usuario de la aplicación.

Ejemplo de cURL

Ejemplo de solicitud

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Ejemplo de respuesta (correcto)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Ejemplo de respuesta (error, tipo de contenido multimedia no admitido)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}