Présentation
L’API Graph pour Instagram est un ensemble de points de terminaison de l’API Graph de Facebook mis à la disposition des applications pour accéder aux données dans les comptes professionnels Instagram (Business et Creator). Si vous ne maîtrisez pas l’utilisation de l’API Graph de Facebook, consultez notre documentation sur l’API Graph avant de poursuivre.
URL de base
Tous les points de terminaison sont accessibles par le biais de l’hôte graph.facebook.com.
Utilisateurs et utilisatrices de votre application
Les comptes professionnels Instagram étant accessibles indirectement via les comptes Facebook, les utilisateurs et utilisatrices doivent disposer d’un compte Facebook et l’utiliser pour se connecter à votre application. De plus, le compte Facebook doit être autorisé à exécuter des tâches équivalentes à des tâches d’admin sur la Page Facebook connectée au compte Instagram auquel les utilisateurs et utilisatrices tentent d’accéder.
Ces exigences s’appliquent à l’ensemble des utilisateurs et utilisatrices de l’application, y compris ceux et celles qui ont un rôle dans votre application ou dans l’entreprise qui la revendique.
Authentification
L’authentification des utilisateurs et utilisatrices de votre application est gérée par des tokens d’accès. L’accès aux comptes professionnels Instagram se fait indirectement via des comptes Facebook, c’est pourquoi toutes les requêtes d’API doivent inclure le token d’accès utilisateur Facebook des utilisateurs et utilisatrices de votre application. Vous pouvez obtenir des tokens des utilisateurs et utilisatrices de l’application en installant Facebook Login. Facebook Login ne prend pas en charge les identifiants Instagram. Par conséquent, les utilisateurs et utilisatrices doivent se connecter à votre application via un compte Facebook.
Autorisation
L’accès aux points de terminaison est géré par des autorisations et des fonctionnalités. Pour que votre application puisse accéder aux données Instagram de l’utilisateur ou l’utilisatrice via un point de terminaison, vous devez d’abord demander toutes les autorisations requises par ce point de terminaison à l’utilisateur ou l’utilisatrice de l’application, qui doit ensuite accorder ces autorisations à votre application. Lorsque c’est fait, vous pouvez interroger les points de terminaison afin d’accéder aux données de l’utilisateur ou l’utilisatrice.
Notez qu’une autorisation ne permet d’accéder qu’aux données créées par l’utilisateur ou l’utilisatrice qui a accordé l’autorisation. Certains points de terminaison permettent d’accéder aux données qui n’ont pas été créées par l’utilisateur ou l’utilisatrice, mais celles-ci sont alors limitées et publiques.
Vous pouvez demander des autorisations des utilisateurs ou utilisatrices de votre application en installant Facebook Login. Les utilisateurs et utilisatrices qui disposent d’un rôle dans votre application peuvent accorder n’importe quelle autorisation. Les utilisateurs et utilisatrices qui ne disposent pas d’un rôle dans votre application ne peuvent accorder que les autorisations et fonctionnalités qui ont été soumises au processus de Contrôle app.
L’API utilise les autorisations et fonctionnalités suivantes :
Reportez-vous à la référence sur les points de terminaison pour déterminer les autorisations et fonctionnalités que votre application devra demander aux utilisateurs et utilisatrices.
Messagerie Instagram
Si vous prévoyez d’implémenter la messagerie Instagram à partir de la plateforme Messenger, vous devrez inclure l’autorisation instagram_manage_messages. En savoir plus sur la messagerie Instagram. 
Collaborateurs
La fonctionnalité de collaboration Instagram permet aux utilisateurs et utilisatrices d’application Instagram de co-créer des contenus (c’est-à-dire de publier des contenus multimédias) avec d’autres comptes (collaborateur·ices).
À quelques exceptions près, les données contenues dans les médias co-créés ou s’y rapportant sont uniquement accessibles via l’API par les personnes qui ont publié le média. Les collaborateurs et collaboratrices n’ont pas accès à ces données via l’API. Les seules exceptions à cette règle concernent la recherche des médias les plus performants ou ceux récemment publiés et qui ont été identifiés au moyen d’un hashtag spécifique. Consultez pour cela la section Hashtag Search.
Pages
Les comptes professionnels Instagram doivent être connectés à une Page Facebook pour que leurs données soient accessibles via l’API. Une fois connecté·es, les utilisateur·ices Facebook autorisé·es à exécuter des tâches sur cette Page peuvent accorder à votre application un token d’accès, qui pourra ensuite être utilisé dans les requêtes d’API.
Vous découvrirez comment connecter une Page Facebook à un compte professionnel Instagram dans notre article d’aide intitulé Ajouter une Page Facebook associée à votre compte professionnel Instagram ou la modifier.
Tâches
Pour qu’un utilisateur ou une utilisatrice de votre application puisse accorder des autorisations, il ou elle doit être autorisé·e à exécuter des tâches sur la Page Facebook connectée au compte Instagram auquel il ou elle tente d’accéder. Les utilisateurs et utilisatrices peuvent accorder des autorisations en fonction des tâches qu’ils et elles sont autorisé·es à exécuter :
| Autorisation | MANAGE | CREATE_CONTENT | MODERATE | ADVERTISE | ANALYZE |
|---|---|---|---|---|---|
instagram_basic | ✔ | ✔ | ✔ | ✔ | ✔ |
instagram_content_publish | ✔ | ✔ | |||
instagram_manage_comments | ✔ | ✔ | ✔ | ||
instagram_manage_insights | ✔ | ✔ | ✔ | ✔ | ✔ |
Vous pouvez déterminer les tâches auxquelles un utilisateur ou une utilisatrice est autorisé·e à exécuter sur une Page en interrogeant le point de terminaison GET /me/accounts à l’aide du token d’accès de l’utilisateur ou l’utilisatrice de l’application. Ce point de terminaison renverra une liste des Pages sur lesquelles l’utilisateur ou l’utilisatrice est autorisé·e à exécuter des tâches, et indiquera quelles tâches il ou elle peut effectuer sur chacune d'elles.
Reportez-vous à la documentation de référence pour connaître les autorisations requises par chaque point de terminaison. L’API ne prend pas en charge les utilisateurs système Business Manager ni les utilisateurs et utilisatrices de l’application qui disposent d’un rôle de contributeur ou contributrice en direct.
Référence aux tâches
Si vous souhaitez fournir aux utilisateurs et utilisatrices de l’application des informations sur les tâches (et sur celles qui sont requises pour utiliser correctement votre application), voici comment elles sont référencées dans nos interfaces utilisateur.
Pages classiques
Les pages classiques font référence aux tâches en tant que rôles. Les utilisateurs et utilisatrices qui disposent d’un rôle d’admin sur une Page peuvent accorder n’importe quelle autorisation à votre application. Les utilisateurs et utilisatrices qui disposent d’autres rôles peuvent accorder les autorisations suivantes :
| Rôle | Autorisations accordables |
|---|---|
Éditeur | instagram_basic |
Modérateur | instagram_basic |
Annonceur | instagram_basic |
Analyste | instagram_basic |
Nouvelle version des Pages
La nouvelle version des Pages fait référence aux tâches en tant qu’Accès Facebook ou Accès par tâche. Les utilisateurs et utilisatrices qui disposent d’un accès Facebook sur une Page peuvent accorder n’importe quelle autorisation à votre application. Les utilisateurs et utilisatrices qui disposent d’un Accès par tâche peuvent accorder les autorisations suivantes :
| Accès par tâche | Autorisations accordables |
|---|---|
Publicités | instagram_basic |
Contenu | instagram_basic |
Insights | instagram_basic |
Messages et activité de la communauté | instagram_basic |
Pour déterminer si une Page utilise la nouvelle version, demandez son champ has_transitioned_to_new_page_experience. La valeur renvoyée est true si la Page utilise la nouvelle version.
Contrôle app
Vous devez soumettre votre application au Contrôle app avant que celle-ci puisse être utilisée par des utilisateurs et utilisatrices de l’application qui ne disposent pas d’un rôle dans votre application ou d’un rôle dans l’entreprise qui la revendique. Si votre application est destinée uniquement à des utilisateurs et utilisatrices qui disposent d’un rôle dans votre application ou dans l’entreprise, le processus de Contrôle app est inutile.
Il n’est pas nécessaire d’inclure un utilisateur ou une utilisatrice test de Facebook dans votre demande si vous avez implémenté Facebook Login et que votre application est accessible publiquement. Toutefois, si nos examinateurs et examinatrices ont besoin de se connecter à un compte non-Facebook pour déclencher votre implémentation de Facebook Login, vous devrez inclure les informations de connexion à ce compte dans votre demande.
Applications privées
Si nos examinateurs et examinatrices ne parviennent pas à tester votre application parce qu’elle se trouve dans un intranet privé, qu’elle n’a pas d’interface utilisateur ou qu’elle n’utilise pas Facebook Login, vous pouvez uniquement demander l’approbation des autorisations suivantes :
Vérification de l’entreprise
Vous devez soumettre votre application à une vérification de l’entreprise si elle est utilisée exclusivement par des utilisateurs et utilisatrices qui ne disposent pas d’un rôle dans l’application ou d’un rôle dans une entreprise qui la revendique.
Limitation de débit
Tous les points de terminaison sont soumis à une limitation de débit Instagram du cas d’utilisation d’entreprise à l’exception des points de terminaison Business Discovery et Hashtag Search qui obéissent aux limitations de débit de la plateforme.
Webhooks
Vous pouvez utiliser des Webhooks pour recevoir des notifications lorsqu’un utilisateur ou une utilisatrice fait un commentaire sur des objets de contenu multimédia des utilisateurs et utilisatrices de votre application ou lorsqu’une de ses stories expire. Reportez-vous à notre documentation sur les Webhooks pour découvrir comment utiliser les Webhooks, comment installer un Webhook pour Instagram et comment s’abonner aux champs comments et story_insights correspondants.
Messagerie Instagram
Certains points de terminaison de l’API Graph pour Instagram sont utilisés avec ceux de l’API de la plateforme Messenger pour autoriser les utilisateurs et utilisatrices de votre application à interagir avec vos messages Direct envoyés sur leurs comptes professionnels Instagram. Consultez la documentation sur la messagerie Instagram de la plateforme Messenger pour découvrir comment accéder aux messages dans les comptes professionnels Instagram.