Utilisateur·ice Instagram

Représente un compte business Instagram ou un compte Creator Instagram.

Nous utilisons « utilisateur·ice Instagram » et « compte Instagram » de façon interchangeable dans l’ensemble de notre documentation. Ces deux expressions désignent le compte Instagram professionnel de l’utilisateur ou l’utilisatrice de votre application.

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.

Création

Cette opération n’est pas prise en charge.

Lecture

GET /<IG_USER_ID>

Ajoutez des champs et des arêtes sur un compte Instagram Business ou Creator.

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

Syntaxe de la requête

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

Paramètres du chemin

Espace réservé	Valeur
`<API_VERSION>`	Version de l’API.
`<IG_USER_ID>`	Obligatoire. Identifiant de l’utilisateur·ice Instagram.

Paramètres de la chaîne de requête

Clé	Espace réservé	Valeur
`access_token`	`<ACCESS_TOKEN>`	Obligatoire. Token d’accès utilisateur de l’utilisateur·trice de l’application.
`fields`	`<LIST_OF_FIELDS>`	Liste des champs de type Utilisateur·ice Instagram séparés par une virgule que vous souhaitez renvoyer pour chaque utilisateur·ice Instagram dans les résultats.

Champs

Les champs publics peuvent être renvoyés par une arête dans le cas d’un élargissement du champ. Seuls quelques champs seront disponibles pour accéder à des comptes Instagram associés à une Page.

Nom du champ	Description
`alt_text` Public	Texte décrivant une image à des fins d’accessibilité.
`biography` Public	Texte de la bio du profil.
`followers_count` Public	Nombre total d’utilisateur·ices Instagram abonné·es à cet utilisateur ou cette utilisatrice.
`follows_count`	Nombre total de comptes Instagram auxquels cet utilisateur ou cette utilisatrice est abonné·e.
`has_profile_pic`	Indique si le compte professionnel Instagram de l’utilisateur·ice de votre application a une photo de profil.
`id` Public	Identifiant utilisateur·ice spécifique à une application. Disponible pour les comptes Instagram associés à une Page.
`is_published`	Indique si le compte Instagram de l’utilisateur·ice de votre application est publié. Disponible pour les comptes Instagram associés à une Page.
`legacy_instagram_user_id`	ID Instagram de l’utilisateur·ice de votre application créé pour les points de terminaison de l’API Marketing dans les versions 21.0 et antérieures. Disponible pour les comptes Instagram associés à une Page.
`media_count` Public	Nombre total de contenus multimédias Instagram publiés sur le compte de l’utilisateur·ice de votre application.
`name`	Nom de profil Instagram de l’utilisateur·ice de votre application.
`profile_picture_url`	URL de la photo de profil Instagram de l’utilisateur·ice de votre application.
`shopping_product_tag_eligibility`	Renvoie `true` si l’utilisateur ou l’utilisatrice de votre application a configuré une boutique Instagram et a ainsi le droit d’ajouter un tag de produit. Dans le cas contraire, renvoie `false`.
`username` Public	Nom d’utilisateur·ice associé au profil Instagram de l’utilisateur·ice de votre application.
`website` Public	URL du site Web de l’utilisateur ou de l’utilisatrice de votre application.

Arêtes

Arête	Description
`agencies`	Liste d’entreprises qui peuvent diffuser des annonces pour ce compte Instagram professionnel.
`authorized_adaccounts`	Comptes publicitaires qui peuvent diffuser des annonces pour ce compte Instagram professionnel.
`business_discovery`	Permet d’obtenir des données d’autres utilisateurs·ices Instagram Business ou Creator.
`connected_threads_user`	Représente un compte Threads connecté à un compte Instagram.
`content_publishing_limit`	Représente l’utilisation actuelle de publication de contenu d’un·e utilisateur·ice Instagram.
`insights`	Représente les indicateurs d’interaction sociale sur un·e utilisateur·ice Instagram.
`instagram_backed_threads_user`	Représente un compte Threads associé à un compte Instagram.
`live_media`	Représente un ensemble de vidéos en direct IG Media (contenu multimédia Instagram) associées à un·e utilisateur·ice Instagram.
`media`	Représente un ensemble de contenus multimédias liés à un·e utilisateur·ice Instagram.
`media_publish`	Publie un conteneur Instagram sur un·e utilisateur·ice Instagram Business.
`mentions`	Crée un commentaire Instagram sur un Commentaire Instagram ou un objet de contenu multimédia Instagram comportant une légende dans lequel un·e utilisateur·ice Instagram a été @mentionné·e par un·e autre utilisateur·ice Instagram.
`mentioned_comment`	Permet d’obtenir des données sur un commentaire Instagram dans lequel un·e utilisateur·ice Instagram a été @mentionné·e par un·e autre utilisateur·ice Instagram.
`mentioned_media`	Permet d’obtenir des données sur un contenu multimédia dans lequel un·e utilisateur·ice Instagram a été @mentionné·e dans une légende par un·e autre utilisateur·ice Instagram.
`recently_searched_hashtags`	Permet d’obtenir les hashtags Instagram qu’un·e utilisateur·ice Instagram a recherchés au cours des sept derniers jours.
`stories`	Représente une collection d’objets de contenu multimédia story sur un·e utilisateur·ice Instagram.
`tags`	Représente un ensemble d’objets de contenu multimédia dans lequel un·e utilisateur·ice Instagram a été identifié·e par un autre compte Instagram.
`upcoming_events`	Liste des évènements hébergés par ce compte Instagram professionnel.

Réponse

Objet au format JSON contenant des arêtes et des champs demandés et par défaut.

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

Exemple de cURL

Requête

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

Réponse

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

Mise à jour

Cette opération n’est pas prise en charge.

Suppression

Cette opération n’est pas prise en charge.