Usuario de IG

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

En este documento, usamos "usuario de Instagram" y "cuenta de Instagram" como sinónimos. Ambos representan la cuenta profesional de Instagram del usuario de tu app.

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

No se admite esta operación.

Lectura

GET /<IG_USER_ID>

Obtén campos y perímetros en una cuenta de Instagram para creadores o de Instagram para empresas.

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 IG.

Parámetros de la cadena de consulta

Clave	Marcador de posición	Valor
`access_token`	`<ACCESS_TOKEN>`	Obligatorio. Token de acceso del usuario de la app.
`fields`	`<LIST_OF_FIELDS>`	Lista separada por comas de los campos de usuario de Instagram que deseas que se devuelvan en el conjunto de resultados en relación con cada usuario de Instagram.

Campos

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

Nombre del campo	Descripción
`alt_text` Público	Texto descriptivo de imágenes para accesibilidad.
`biography` Público	Texto de la presentación de perfil.
`followers_count` Público	Cantidad total de usuarios de Instagram que siguen al usuario.
`follows_count`	Cantidad total de usuarios de Instagram que el usuario sigue.
`has_profile_pic`	Indica si la cuenta profesional de Instagram del usuario de tu app tiene una foto de perfil.
`id` Público	Identificador de usuario específico de la app. Disponible para cuentas de Instagram basadas en la página.
`is_published`	Indica si la cuenta de Instagram del usuario de tu app se publicó. Disponible para cuentas de Instagram basadas en la página.
`legacy_instagram_user_id`	El identificador de Instagram del usuario de tu app que se creó para los puntos de conexión de la API de marketing en v21.0 y versiones anteriores. Disponible para cuentas de Instagram basadas en la página.
`media_count` Público	Cantidad total de contenido multimedia de IG publicada en la cuenta del usuario de tu app.
`name`	El nombre de perfil de Instagram del usuario de tu app.
`profile_picture_url`	La URL de la foto de perfil de Instagram del usuario de tu app.
`collaborative_media_search`	Busca un contenido multimedia de colaboración específico por identificador. Acceso mediante la expansión de campos. Disponible solo para la API de Instagram con inicio de sesión con Facebook.
`shopping_product_tag_eligibility`	Devuelve `true` si el usuario de tu app configuró una tienda de Instagram y, por lo tanto, cumple los requisitos para etiquetar productos. De lo contrario, devuelve `false`.
`username` Público	El nombre de usuario del perfil de Instagram del usuario de tu app.
`website` Público	La URL del sitio web del usuario de tu app.

Perímetros

Perímetro	Descripción
`agencies`	Una lista de empresas que pueden publicitar en esta cuenta profesional de Instagram.
`authorized_adaccounts`	Las cuentas publicitarias que pueden publicitar en esta cuenta profesional de Instagram.
`business_discovery`	Obtiene datos sobre otros usuarios de IG de Instagram para empresas o creador.
`connected_threads_user`	Representa una cuenta de Threads conectada a una cuenta de Instagram.
`content_publishing_limit`	Representa el uso actual de la publicación de contenido de un usuario de IG.
`insights`	Representa las métricas de interacción social sobre un usuario de IG.
`instagram_backed_threads_user`	Representa una cuenta de Threads basadas en una cuenta de Instagram.
`live_media`	Representa una colección de contenido multimedia de Instagram de videos en vivo sobre un usuario de Instagram.
`media`	Representa una colección de contenido multimedia de IG de un usuario de IG.
`media_publish`	Publica un contenedor de IG en un usuario de IG de Instagram para empresas.
`mentions`	Crea un comentario de Instagram sobre un comentario de Instagram o sobre contenido multimedia de IG con texto en el que un usuario de Instagram @mencionó a otro usuario de Instagram.
`mentioned_comment`	Obtiene datos de un comentario de IG en el que otro usuario de Instagram @mencionó a un usuario de IG en un texto.
`mentioned_media`	Obtiene datos de un contenido multimedia de IG en el que otro usuario de Instagram @mencionó a un usuario de IG en un texto.
`recently_searched_hashtags`	Obtiene los hashtags de IG que ha buscado un usuario de IG durante los últimos 7 días.
`stories`	Representa una colección de objetos multimedia de IG sobre un usuario de IG.
`tags`	Representa una colección de contenido multimedia de IG en la que a un usuario de IG lo etiquetó otro usuario de Instagram.
`upcoming_events`	Una lista de eventos que organiza 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 IG fue invitado a colaborar.
`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 es propiedad directa del usuario. Disponible solo para la API de Instagram con inicio de sesión con Facebook.

Respuesta

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

{
  "<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

No se admite esta operación.

Eliminación

No se admite esta operación.