Utilisateur·ice Instagram

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

Création

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

Lecture

GET /{ig-user-id}

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

Conditions requises

Type	Description
Tokens d’accès	Utilisateur·trice.
Rôles dans Business Manager	Si vous demandez le champ `shopping_product_tag_eligibility` pour l’identification de produits, l’utilisateur ou l’utilisatrice de l’application doit disposer d’un rôle admin sur le Business Manager qui possède la boutique Instagram de l’utilisateur ou de l’utilisatrice Instagram.
Boutique Instagram	Si vous demandez le champ `shopping_product_tag_eligibility` pour l’identification de produit, l’utilisateur ou l’utilisatrice IG doit avoir une boutique Instagram approuvée avec un catalogue contenant des produits.
Autorisations	`instagram_basic` `pages_read_engagement` `pages_show_list` Si un rôle sur la Page a été attribué à l’utilisateur ou l’utilisatrice de l’application via Business Manager, vous aurez également besoin de l’un des éléments suivants : `ads_management` `business_management` Si vous demandez le champ `shopping_product_tag_eligibility` pour l’identification de produits, vous aurez également besoin des éléments suivants : `catalog_management` `instagram_shopping_tag_products`

Syntaxe de la requête

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={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 chaîne de requête

Clé	Espace réservé	Valeur
`access_token`	`{access-token}`	Obligatoire. Token d’accès Utilisateur de l’utilisateur ou utilisatrice de l’application.
`fields`	`{fields}`	Liste des champs de type Utilisateur Instagram séparés par une virgule que vous souhaitez renvoyer pour chaque utilisateur·trice 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.

Nom du champ	Description
`biography` Public	Texte de la bio du profil.
`id` Public	Identifiant utilisateur spécifique à une app.
`ig_id`	Identifiant utilisateur Instagram. Utilisé avec l’ancienne API Instagram, désormais obsolète. Utilisez plutôt `id`.
`followers_count` Public	Nombre total d’utilisateur·trices Instagram abonné·es à cet utilisateur ou cette utilisatrice.
`follows_count`	Nombre total d’utilisateur·trices Instagram auxquel·les cet utilisateur ou utilisatrice est abonné·e.
`media_count` Public	Nombre total de contenus IG Media publiés par l’utilisateur ou l’utilisatrice.
`name`	Nom du profil.
`profile_picture_url`	URL de l’image de profil.
`shopping_product_tag_eligibility`	Renvoie `true` si l’utilisateur ou l’utilisatrice de l’application a configuré une boutique Instagram et a ainsi le droit d’identifier les produits. Dans le cas contraire, renvoie `false`.
`username` Public	Nom d’utilisateur du profil.
`website` Public	URL du site web du profil unique.

Arêtes

Arête	Description
`business_discovery`	Permet d’obtenir des données d’autres utilisateurs·trices IG Instagram Business ou Creator.
`content_publishing_limit`	Représente l’utilisation actuelle de publication de contenu d’un·e utilisateur·trice Instagram.
`insights`	Représente les indicateurs d’interaction sociale sur un·e utilisateur·trice Instagram.
`live_media`	Représente un ensemble de vidéos en direct IG Media (contenu multimédia Instagram) associées à un·e utilisateur·trice IG.
`media`	Représente un ensemble de contenus multimédia liés à un·eutilisateur·trice Instagram.
`media_publish`	Publie un conteneur IG sur un·e utilisateur·trice IG 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·trice IG a été @mentionné·e par un·e autre utilisateur·trice Instagram.
`mentioned_comment`	Permet d’obtenir des données sur un commentaire Instagram dans lequel un·e utilisateur·trice Instagram a été @mentionné·e par un·e autre utilisateur·trice Instagram.
`mentioned_media`	Permet d’obtenir des données sur un contenu multimédia dans lequel un·e utilisateur·trice Instagram a été @mentionné·e dans une légende par un·e autre utilisateur·trice Instagram.
`recently_searched_hashtags`	Permet d’obtenir les hashtags Instagram qu’un·e utilisateur·trice IG 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·trice Instagram.
`tags`	Représente un ensemble d’objets de contenu multimédia dans lequel un·e utilisateur·trice Instagram a été identifié·e par un·e autre utilisateur·trice Instagram.

Réponse

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

{
  "{field}":"{value}",
  ...
}

Exemple de cURL

Demande

curl -X GET \
  'https://graph.facebook.com/v19.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.