Plataforma de Instagram

Contenido multimedia de Instagram

Representa un álbum, una foto, un reel, una historia o un video (un video subido, en vivo o creado con la app Instagram TV, un reel o una historia) 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).
  • Es necesario compartir el contenido multimedia de Instagram TV en Instagram en el momento de realizar la publicación (función Publicar una vista previa o Compartir vista previa en el feed activada) para que esté disponible mediante la API.
  • El contenido multimedia de Instagram de videos en vivo solo puede leerse mientras se está transmitiendo.

Requisitos

TipoDescripción

Tokens de acceso

Usuario.

Permisos

instagram_basic
pages_read_engagement
pages_show_list


Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página, también necesitarás alguno de los siguientes elementos:


ads_management
business_management

Sintaxis de la solicitud

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={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 de contenido multimedia de Instagram.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

{access-token}

Obligatorio.Token de acceso de usuario de la app.

fields

{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

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 administradores en la página de Facebook conectada a la cuenta de Instagram usada para crear el pie de foto.

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.

ig_id
Público

Identificador de contenido multimedia de Instagram. Usuario con la API de Instagram heredada, ahora obsoleta. En su lugar, usa id.

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 fueron creadas a partir del contenido multimedia.


Si se realiza la consulta de manera indirecta a través de otro punto de conexión o expansión de campos:


  • Llamadas de la versión 10.0 o posterior: el valor será 0 si el propietario del contenido multimedia tiene los conteos de Me gusta ocultos.
  • Llamadas de la versión 11.0 o posterior: el campo like_count se omite si el propietario del contenido multimedia tiene conteos de Me gusta ocultos.

media_product_type
Público

Superficie en la que se publica el contenido multimedia. Puede ser AD, FEED, STORY o REELS.

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.

video_title
Público

Obsoleto. Se omite en la respuesta.

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.

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 multimedia de Instagram.

Ejemplo de cURL

Solicitud

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

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.

Requisitos

TipoDescripción

Tokens de acceso

Usuario.

Permisos

instagram_basic
instagram_manage_comments
pages_show_list


Si se usó el administrador comercial para otorgar un rol al usuario de la app en la página, también necesitarás alguno de los siguientes elementos:


ads_management
business_management

Sintaxis de la solicitud

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &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

{comment-enabled}

Obligatorio. Se configura como true para activar los comentarios o como false para desactivarlos.

Ejemplo de cURL

Solicitud

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

Respuesta

{
  "success": true
}

Eliminación

No se admite esta operación.