Business Discovery

Vous pouvez utiliser l’API Business Discovery pour obtenir des métadonnées et des indicateurs de base concernant les autres comptes Instagram Business et Creator.

Limites

Les données concernant les comptes Instagram Business soumis à une limite d’âge ne sont pas renvoyées.

Points de terminaison

L’API se compose des points de terminaison suivants. Pour plus d’informations sur les exigences liées aux paramètres et aux autorisations, consultez la documentation de référence sur le point de terminaison.

• GET /{ig-user-id}/business_discovery

Exemples

Obtenir le nombre d’abonnés et de contenus multimédias d’un compte

Cet exemple de requête montre comment obtenir le nombre d’abonnés du compte business Instagram Blue Bottle Coffee et le nombre d’objets multimédias publiés sur celui-ci. Comme vous pouvez le voir, les requêtes de découverte d’entreprises sont effectuées sur l’ID du compte business Instagram ou Creator (dans le cas présent, 17841405309211844) et non sur le nom d’utilisateur du compte business Instagram ou Creator sur lequel vous tentez d’obtenir des données (bluebottle dans cet exemple).

Exemple de requête

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count}&access_token={access-token}"

Exemple de réponse

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram Account ID
  },
  "id": "17841405309211844"  // ID of the Instagram account performing the query
}

Obtenir les contenus multimédias

Comme vous pouvez effectuer des requêtes imbriquées en spécifiant une arête via le paramètre fields, vous pouvez demander à l’arête media du compte Business ou Creator ciblé d’obtenir tous les contenus multimédias publiés par le compte :

Exemple de requête

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media}&access_token={access-token}"

Exemple de réponse

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "id": "17858843269216389"
        },
        {
          "id": "17894036119131554"
        },
        {
          "id": "17894449363137701"
        },
        {
          "id": "17844278716241265"
        },
        ... // results truncated for brevity
      ],
    "id": "17841401441775531"
  },
  },
  "id": "17841405309211844"
}

Obtenir des indicateurs de base sur les contenus multimédias

Les requêtes imbriquées et l’élargissement du champ permettent d’obtenir les champs publics des objets multimédias d’un compte Business ou Creator. Notez que cela nous vous autorise pas à accéder directement aux objets multimédias : l’exécution d’une requête GET sur n’importe quel objet multimédia Instagram échouera en raison d’autorisations insuffisantes.

Par exemple, voici comment obtenir le nombre de commentaires et de mentions « J’aime » pour chacun des objets multimédias publiés par Blue Bottle Coffee :

Exemple de requête

curl -i -X GET \
 "https://graph.facebook.com/v3.2/17841405309211844?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}}&access_token={access-token}"

Exemple de réponse

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "media": {
      "data": [
        {
          "comments_count": 50,
          "like_count": 5841,
          "id": "17858843269216389"
        },
        {
          "comments_count": 11,
          "like_count": 2998,
          "id": "17894036119131554"
        },
        {
          "comments_count": 28,
          "like_count": 3644,
          "id": "17894449363137701"
        },
        {
          "comments_count": 43,
          "like_count": 4943,
          "id": "17844278716241265"
        },
        {
          "comments_count": 60,
          "like_count": 9347,
          "id": "17899363132086521"
        },
        {
          "comments_count": 63,
          "like_count": 6913,
          "id": "17893114378137541"
        },
        {
          "comments_count": 16,
          "like_count": 2791,
          "id": "17886057709171561"
        },
        {
          "comments_count": 15,
          "like_count": 3895,
          "id": "17856337633208377"
        },
      ],
    },
    "id": "17841401441775531"
  },
  "id": "17841405976406927"
}