Plataforma de Instagram
Volver al documento en Español (España)
Este documento se ha actualizado.
La traducción en Español (España) no está disponible todavía.
Actualización del documento en inglés: 4 sep.

Contenido multimedia de Instagram

Representa un álbum, una foto o un vídeo (subido, en directo, creado con la aplicación Instagram TV, reel o historia) de Instagram.

A partir del 3 de junio de 2024, puedes utilizar el campo boost_eligibility_info como una manera práctica y eficiente de determinar si el contenido multimedia cumple los requisitos para promocionarse como anuncio. También puedes utilizar el campo boost_ads_list para hacer un seguimiento de la información de anuncios previos de Instagram de promoción relacionada con el anuncio. Consulta el blog para obtener más información. Disponible solo para la API Graph de Instagram.

Creación

Esta operación no es compatible.

Lectura

GET /<IG_MEDIA_ID>

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

Limitaciones

  • Los campos que devuelven valores agregados no incluyen datos procedentes de anuncios. Por ejemplo, comments_count cuenta los comentarios de una foto, pero no los de los anuncios que la incluyen.
  • 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.

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 del contenido multimedia que se va a publicar.

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

access_token

<ACCESS_TOKEN>

Obligatorio. Identificador de acceso 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.

CampoDescripción

boost_ads_list

Ofrece un resumen de toda la información de los anuncios de Instagram que está asociada al contenido multimedia orgánico. Incluye el identificador del anuncio relativo y el estado de la entrega del anuncio. Disponible solo para la API Graph de Instagram.

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. Disponible solo para la API Graph de Instagram.

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 equivalentes a las de administración en la página de Facebook conectada a la cuenta de Instagram utilizada para crear el texto (solo en la API Graph de Instagram).

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 (establecido 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_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 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.

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_product_type
Público

Superficie en la que se publica el contenido multimedia. Puede ser AD, FEED, STORY o REELS. Disponible solo 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 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

Dirección 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 de usuario de la persona que creó el contenido multimedia.

Perímetros

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

PerímetroDescripció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. Disponible solo para la API Graph de Instagram.

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

Limitaciones

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

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

Parámetros de la cadena de consulta

ClaveMarcador de posiciónValor

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

Ejemplo de respuesta

{
  "success": true
}

Eliminación

Esta operación no es compatible.