Plataforma de Instagram
Volver al documento en español
Se actualizó este documento.
La traducción en español no está disponible todavía.
Actualización del documento en inglés: 2 de sep.

Contenido multimedia de Instagram

Representa un álbum, una foto o un video (un video subido, en vivo o creado con la app de Instagram TV, un reel o una historia) de Instagram.

A partir del 3 de junio de 2024, puedes usar el campo boost_eligibility_info como una forma cómoda y eficaz de determinar si el contenido multimedia es apto para que se lo promocione como anuncio, y el campo boost_ads_list para rastrear información pasada relacionada con el anuncio promocionado de Instagram. Consulta el blog para obtener más información. Disponible únicamente para la API Graph de Instagram.

Creación

No se admite esta operación.

Lectura

GET /<IG_MEDIA_ID>

Obtiene campos y perímetros en contenido multimedia de Instagram.

Limitaciones

  • Los campos que devuelven valores agregados no incluyen datos basados en anuncios. Por ejemplo, comments_count cuenta los comentarios de una foto, pero no los comentarios de los anuncios que contengan esa foto.
  • Los comentarios no incluyen el símbolo @ a menos que el usuario de la app también pueda realizar tareas equivalentes a las del administrador en la app.
  • Algunos campos, como permalink, no se pueden usar en fotos dentro de álbumes (objetos secundarios).
  • El contenido multimedia de Instagram de videos en vivo solo puede leerse durante la transmisión.
  • Esta API devuelve solo datos de contenido multimedia que pertenece a cuentas profesionales de Instagram. No se puede usar para obtener datos de contenido multimedia de cuentas personales de Instagram.

Sintaxis de la solicitud

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Parámetros de ruta

Marcador de posiciónValor

<API_VERSION>

Versión de la API.

<IG_MEDIA_ID>

Obligatorio. Identificador para publicar el contenido multimedia.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

<ACCESS_TOKEN>

Obligatorio. Token de acceso del usuario de la app.

fields

<LIST_OF_FIELDS>

Una lista separada por comas de los campos que deseas que se devuelvan.

Campos

Se pueden leer los campos públicos mediante la expansión de campos.

CampoDescripción

boost_ads_list

Ofrece un resumen de toda la información publicitaria de Instagram asociada con el contenido multimedia orgánico. Incluye el identificador del anuncio relativo y el estado de entrega de anuncios. Disponible únicamente para la API Graph de Instagram.

boost_eligibility_info

El campo proporciona información sobre cómo potenciar la aplicabilidad de un contenido multimedia de Instagram como anuncio y detalles adicionales si no es aplicable. Disponible únicamente para la API Graph de Instagram.

caption
Público

Pie de foto. Excluye los objetos secundarios del álbum. Se excluye el símbolo @, salvo que el usuario de la app pueda realizar tareas equivalentes a las de los administradores en la página de Facebook conectada a la cuenta de Instagram usada para crear el texto (solo API Graph de Instagram).

comments_count
Público

Conteo de comentarios en el contenido multimedia. Excluye los comentarios en el contenido multimedia de los objetos secundarios y la leyenda del contenido multimedia. Incluye las respuestas de los comentarios.

copyright_check_information.status

Devuelve objetos status y matches_found.

Objetos de estadoDescripción

status

  • completed: el proceso de detección finalizó.
  • error: se produjo 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 comenzó.

matches_found

Configura alguna de las siguientes opciones:

  • false si el video no infringe los derechos de autor.
  • true si el video infringe los derechos de autor.

Si un video infringe los derechos de autor, se devuelve copyright_matches con una matriz de objetos referidos al material protegido por derechos de autor, si la infracción se produce en el video, y con las acciones que se deben tomar para solucionar dicha infracción.

Objetos copyright_matchesDescripción

author

El autor del video protegido por derechos de autor

content_title

El nombre del video protegido por derechos de autor

matched_segments

Una matriz de objetos con los siguientes pares clave-valor: * duration_in_seconds, el número de segundos en que el contenido infringe los derechos de autor; * segment_type, ya sea AUDIO o VIDEO;* start_time_in_seconds, configurado en la hora de inicio del video.

owner_copyright_policy

Los objetos devueltos incluyen lo siguiente:

  • name: el nombre de la política de los propietarios de los derechos de autor

  • actions: una matriz de objetos action con los pasos que se tomaron para solucionar la infracción y que se establecen en la política del propietario de los derechos de autor. Puede incluir diferentes pasos de mitigación para diferentes ubicaciones.

    • action: la acción de mitigación que se toma para solucionar la infracción de los derechos de autor. Se pueden tomar diferentes medidas de mitigación en diferentes países. Puede ser cualquiera de los siguientes valores:
      • BLOCK: se bloqueó el video de los públicos que figuran en la matriz geos.
      • MUTE: el video está silenciado para los públicos que figuran en la matriz geos.

id
Público

Identificador de contenido multimedia.

is_comment_enabled

Indica si los comentarios están activados o desactivados. Excluye los objetos secundarios del álbum.

is_shared_to_feed
Público

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.

like_count

Conteo de "Me gusta" en el contenido multimedia, incluso en las respuestas a los comentarios. Excluye los "Me gusta" en el contenido multimedia de los objetos secundarios de álbum en las publicaciones promocionadas que se crearon a partir del contenido multimedia.


Si se consulta indirectamente a través de otro punto de conexión o expansión de campo, se omite el campo like_count en caso de que el propietario del contenido multimedia haya ocultado el recuento de "Me gusta".

media_product_type
Público

Superficie en la que se publica el contenido multimedia. Puede ser AD, FEED, STORY o REELS. Disponible únicamente para la API Graph de Instagram.

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 omitirá de las respuestas si el contenido multimedia incluye material protegido por derechos de autor o si se marcó debido a una infracción de derechos de autor. Entre los ejemplos de material protegido por derechos de autor, se puede incluir 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 app que realiza la consulta también creó el contenido multimedia. De lo contrario, se devolverá el campo username.

permalink
Público

URL permanente del contenido multimedia.

shortcode
Público

Código corto de acceso al contenido multimedia.

thumbnail_url
Público

URL de la imagen en miniatura del contenido multimedia. Solo disponible en el contenido multimedia VIDEO.

timestamp
Público

La fecha de creación en formato ISO 8601, en zona horaria UTC (la forma predeterminada es UTC ±00:00).

username
Público

Nombre de usuario de quien creó el contenido multimedia.

Perímetros

Se pueden devolver los perímetros públicos si se usa la expansión de campos.

PerímetroDescripción

children
Público

Representa una colección de objetos multimedia de IG a partir de un álbum de contenido multimedia de IG.

collaborators

Representa una lista de usuarios que se agregaron como colaboradores en un objeto de contenido multimedia de Instagram. Disponible únicamente para la API Graph de Instagram.

comments

Representa una colección de comentarios de IG en un objeto multimedia de IG.

insights

Representa las métricas de interacción social sobre un objeto de contenido multimedia de Instagram. Disponible únicamente para la API Graph de Instagram.

Ejemplo de cURL

Ejemplo de solicitud

curl -X GET \
  'https://graph.instagram.com/v21.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 multimedia de IG.

Limitaciones

No se admite el contenido multimedia de IG de videos en vivo.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram 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
  • pages_show_list

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
  • business_management

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posiciónValor

<API_VERSION>

Versión de la API.

<IG_MEDIA_ID>

Obligatorio. Identificador de contenido multimedia de Instagram.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

<ACCESS_TOKEN>

Obligatorio.Token de acceso del usuario de la app.

comment_enabled

<BOOL>

Obligatorio. Se configura 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/v21.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Ejemplo de respuesta

{
  "success": true
}

Eliminación

No se admite esta operación.