Usuario de Instagram

Representa una cuenta empresarial de Instagram o una cuenta de creador de Instagram.

En nuestra documentación, utilizamos “usuario de Instagram” y “cuenta de Instagram” indistintamente. Ambos términos representan la cuenta profesional de Instagram del usuario de la aplicación.

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User 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_basic` `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` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

Creación

Esta operación no es compatible.

Lectura

GET /<IG_USER_ID>

Obtén campos y perímetros en una cuenta empresarial o de creador de Instagram.

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

Sintaxis de la solicitud

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

Parámetros de ruta

Marcador de posición	Valor
`<API_VERSION>`	Versión de la API.
`<IG_USER_ID>`	Obligatorio. Identificador del usuario de Instagram.

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.
`fields`	`<LIST_OF_FIELDS>`	Lista separada por comas de los campos de usuario de Instagram que quieres que se devuelvan para cada usuario de Instagram en el conjunto de resultados.

Campos

Un perímetro puede devolver los campos públicos mediante la expansión de campos. Solo algunos de los campos estarán disponibles para acceder a las cuentas de Instagram basadas en una página.

Nombre del campo	Descripción
`alt_text` Público	Texto descriptivo de las imágenes, con fines de accesibilidad.
`biography` Público	Texto de la biografía del perfil.
`followers_count` Público	Número total de usuarios de Instagram que siguen al usuario.
`follows_count`	Número total de usuarios de Instagram a los que sigue el usuario.
`has_profile_pic`	Indica si la cuenta profesional de Instagram del usuario de la aplicación tiene foto de perfil.
`id` Público	Identificador de usuario específico de la aplicación. Disponible para cuentas de Instagram basadas en una página.
`is_published`	Indica si la cuenta de Instagram del usuario de la aplicación está publicada. Disponible para cuentas de Instagram basadas en una página.
`legacy_instagram_user_id`	Identificador de Instagram del usuario de la aplicación que se creó para los extremos de la API de marketing en la versión 21.0 y versiones posteriores. Disponible para cuentas de Instagram basadas en una página.
`media_count` Público	Número total de objetos de contenido multimedia de Instagram publicados en la cuenta del usuario de la aplicación.
`name`	Nombre del perfil de Instagram del usuario de la aplicación.
`profile_picture_url`	URL de la foto del perfil de Instagram del usuario de la aplicación.
`collaborative_media_search`	Busca un contenido multimedia colaborativo específico por identificador. Accede mediante la expansión de campos. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.
`shopping_product_tag_eligibility`	Devuelve `true` si el usuario de la aplicación ha configurado una tienda de Instagram y, por lo tanto, cumple los requisitos para el etiquetado de productos; en caso contrario, devuelve `false`.
`username` Público	Nombre de usuario del perfil de Instagram del usuario de la aplicación.
`website` Público	URL del sitio web del usuario de la aplicación.

Perímetros

Perímetro	Descripción
`agencies`	Lista de las empresas que pueden publicar anuncios para esta cuenta profesional de Instagram.
`authorized_adaccounts`	Cuentas publicitarias que pueden publicar anuncios para esta cuenta profesional de Instagram.
`business_discovery`	Obtén datos sobre otros usuarios de Instagram de cuentas empresariales o de creador de Instagram.
`connected_threads_user`	Representa una cuenta de Threads conectada a una cuenta de Instagram.
`content_publishing_limit`	Representa el uso actual de publicación de contenido de un usuario de Instagram.
`insights`	Representa las métricas de interacción social de un usuario de Instagram.
`instagram_backed_threads_user`	Representa una cuenta de Threads respaldada por una cuenta de Instagram.
`live_media`	Representa una colección de contenido multimedia de Instagram de vídeo en directo de un usuario de Instagram.
`media`	Representa una colección de contenido multimedia de Instagram de un usuario de Instagram.
`media_publish`	Publica un contenedor de Instagram en un usuario de Instagram para empresas.
`mentions`	Crea un comentario de Instagram en un comentario de Instagram o contenido multimedia de Instagram con texto en que un usuario de Instagram haya sido @mencionado por otro.
`mentioned_comment`	Obtén datos sobre un comentario de Instagram en el que un usuario de Instagram haya sido @mencionado por otro.
`mentioned_media`	Obtén datos sobre un objeto de contenido multimedia de Instagram en el que un usuario de Instagram haya sido @mencionado por otro en un texto.
`recently_searched_hashtags`	Obtén los hashtags de Instagram que ha buscado un usuario de Instagram durante los últimos 7 días.
`stories`	Representa una colección de los objetos de contenido multimedia de Instagram de historias de un usuario de Instagram.
`tags`	Representa una colección de contenido multimedia de Instagram en el que un usuario de Instagram ha etiquetado a otro.
`upcoming_events`	Lista de los eventos que aloja esta cuenta profesional de Instagram.
`collaboration_invites`	Representa una colección de atributos de objeto `IG Media` (media_id, media_owner_username, caption, media_url) para los que el usuario de Instagram ha recibido una invitación de colaboración.
`collaborative_media`	Representa una colección de contenido multimedia de Instagram en la que el usuario de Instagram es un colaborador aceptado. No incluye el contenido multimedia que el usuario posee directamente. Solo está disponible para la API de Instagram con el inicio de sesión con Facebook.

Respuesta

Objeto con formato JSON que contiene los campos y los perímetros solicitados y predeterminados.

{
  "<FIELD>":"<VALUE>",
  ...
}

Ejemplo de cURL

Solicitud

curl -X GET \
  'https://graph.facebook.com/v25.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

Respuesta

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

Actualización

Esta operación no es compatible.

Eliminación

Esta operación no es compatible.