Utilisateur·ice

Représente le profil d’un·e utilisateur·ice Instagram.

Les ID utilisateur spécifiques d’une app (ASID) ont été introduites avec la version 11.0 de l’API. Vous pouvez continuer à interroger les utilisateurs en fonction de leur ID brut ou de l’ASID équivalent. Toutefois, avec les appels version 11.0 et ultérieurs, la requête renvoie des ASID.

Les ASID remplaceront les ID utilisateurs bruts dans approximativement deux ans lorsque la version 10.0 ne sera plus prise en charge. Nous vous recommandons de ce fait de commencer à mapper les utilisateurs de vos applications sur leurs ASID équivalents.

Création

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

Lecture

GET /{user-id}

Obtient des champs et des arêtes sur un·e utilisateur·ice.

Limites

Les anciens ID utilisateur de l’API Instagram ne sont pas pris en charge.

Conditions requises

Type	Condition requise
Tokens d’accès	Utilisateur·ice Instagram
Autorisations	`instagram_graph_user_profile`. Le champ`media_count` nécessite également `instagram_graph_user_media`.

Syntaxe de la requête

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

Paramètres du chemin

Espace réservé	Valeur
`{api-version}` Chaîne	Version de l’API.
`{user-id}` Obligatoire Chaîne	ID utilisateur spécifique à une application (versions 11.0 et ultérieures) ou ID utilisateur brut (toutes les versions) de l’utilisateur·ice de l’application.

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

Inclure les paramètres de chaîne de requête suivants pour augmenter la demande.

Clé	Valeur
`access_token` Obligatoire Chaîne	Token d’accès pour utilisateur Instagram de l’utilisateur·ice de l’application.
`fields` Liste d’éléments séparés par une virgule	Liste des arêtes et des champs (séparés par des virgules) à renvoyer. En cas d’omission, les champs par défaut sont renvoyés.

Champs

Vous pouvez utiliser le paramètre de chaîne de requête fields pour demander les champs suivants sur un·e utilisateur·ice.

Nom du champ	Description
`account_type`	Type de compte de l’utilisateur·ice. La valeur peut être `BUSINESS`, `MEDIA_CREATOR` ou `PERSONAL`.
`id`	ID spécifique à une application (versions 11.0 et ultérieures) ou ID utilisateur brut (versions 10.0 et antérieures) de l’utilisateur·ice de l’application.
`media_count`	Nombre de contenus multimédias sur l’utilisateur·ice. Ce champ nécessite l’autorisation `instagram_graph_user_media`.
`username`	Nom d’utilisateur·ice.

Arêtes

Vous pouvez interroger les arêtes suivantes en tant que paramètres du chemin ou en utilisant le paramètre de chaîne de requête fields.

Arête	Description
`media`	Obtient une liste de contenus multimédias sur l’utilisateur·ice.

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.instagram.com/v21.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

Réponse

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

Mise à jour

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

Suppression

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