Business Discovery pour un utilisateur IG

Permet d’obtenir des données sur les autres utilisateurs IG Instagram Business ou créateur.

Création

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

Lecture

GET /{ig-user-id}?fields=business_discovery.username({username})

Renvoie des données sur un autre utilisateur IG Instagram Business ou créateur. Effectuez cette demande sur l’utilisateur IG Instagram Business ou créateur qui fait la requête et identifiez l’entreprise ciblée avec le paramètre username.

Limites

Les données sur les utilisateurs IG Instagram Business soumis à une limite d’âge ne seront pas renvoyées.

Paramètres de chaîne de requête

{username} (obligatoire) : nom de l’utilisateur IG Instagram Business ou créateur sur lequel vous souhaitez obtenir des données.

Autorisations

Un token d’accès utilisateur Facebook avec les autorisations suivantes :

instagram_basic
instagram_manage_insights
pages_read_engagement ou pages_show_list

Si le token émane d’un utilisateur ou une utilisatrice dont le rôle sur la Page a été attribué par le biais du compte Business Manager, l’une des autorisations suivantes est également requise :

ads_management
pages_read_engagement
business_management

Élargissement de champ

Vous pouvez utiliser l’élargissement de champ pour obtenir des champs publics sur l’utilisateur IG ciblé. Consultez la référence Utilisateur IG pour obtenir une liste des champs publics.

Exemple de demande avec élargissement de champ

Obtention de données sur l’utilisateur IG Instagram Business « Blue Bottle Coffee » et utilisation de l’élargissement de champ pour demander le nombre de ses abonnés et contenus multimédias.

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count}

Exemple de réponse

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Accès aux arêtes avec élargissement de champ

Vous pouvez également utiliser l’élargissement de champ pour accéder à l’arête /media sur l’utilisateur IG ciblé et spécifier les champs et les indicateurs qui doivent être renvoyés pour chaque objet IG Media. Consultez la référence nœud Media pour obtenir une liste des champs publics.

Appels des versions 10.0 et antérieures jusqu’au 7 septembre 2021 : le champ like_count associé à un contenu multimédia Instagram renvoie la valeur 0 si le propriétaire du contenu a choisi de masquer les mentions J’aime pour ce contenu.

Appels des versions 11.0 et ultérieures à partir du 7 septembre 2021 : si vous interrogez un contenu multimédia Instagram de manière indirecte par le biais d’un autre point de terminaison ou élargissement de champ, le champ like_count sera omis des réponses de l’API si le propriétaire du contenu multimédia a masqué les mentions J’aime pour ce contenu. Si vous interrogez le contenu multimédia Instagram de manière directe, c’est-à-dire par l’intermédiaire de son propriétaire, le nombre réel de mentions J’aime sera renvoyé, même si le propriétaire a masqué les mentions J’aime pour ce contenu.

Exemple de demande avec une arête

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){followers_count,media_count,media}

Exemple de réponse avec une arête

{
  "business_discovery": {
    "followers_count": 267788,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        {
          "id": "17911489846004508"
        }
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405309211844"
}

Pagination

L’arête /media prend en charge la pagination en fonction de curseurs, de sorte que si vous y accédez via l’élargissement de champ, la réponse inclura les curseurs before et after si la réponse contient plusieurs pages de données. Toutefois, à la différence de la pagination en fonction de curseurs standard, la réponse n’inclura pas les champs previous ou next, vous devrez donc utiliser les curseurs before et after pour construire manuellement les chaînes de requête previous et next afin de parcourir les pages de l’ensemble de données renvoyé.

Exemple de requête

GET graph.facebook.com
  /17841405309211844
    ?fields=business_discovery.username(bluebottle){media{comments_count,like_count}}

Exemple de réponse

{
  "business_discovery": {
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5837,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2997,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3643,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
     ],
   },
   "id": "17841401441775531"
  },
  "id": "17841405976406927"
}

Mise à jour

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

Suppression

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