Business Discovery

Vous pouvez utiliser l’API Instagram avec Facebook Login pour obtenir des métadonnées et des indicateurs de base concernant les autres comptes Instagram professionnels.

Limites

Les données concernant les comptes Instagram professionnels 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 /<YOUR_APP_USERS_IG_USER_ID>/business_discovery

Exemples

Obtenir le nombre de followers et de contenus multimédias

Cet exemple de requête montre comment obtenir le nombre de followers du compte Instagram professionnel 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 Instagram professionnel (dans le cas présent, 17841405309211844) avec le nom d’utilisateur·ice du compte Instagram professionnel sur lequel l’utilisateur·ice de votre application tente d’obtenir des données (bluebottle dans cet exemple).

Exemple de requête

Le code a été mis en forme pour plus de lisibilité.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_ACCESS_TOKEN>"

Exemple de réponse

{
  "business_discovery": {
    "followers_count": 267793,
    "media_count": 1205,
    "id": "17841401441775531" // Blue Bottle's Instagram user ID
  },
  "id": "17841405309211844"  // Your app user's Instagram user ID
}

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 professionnel ciblé d’obtenir tous les contenus multimédias publiés par le compte.

Exemple de requête

Le code a été mis en forme pour plus de lisibilité.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_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

Le code a été mis en forme pour plus de lisibilité.

curl -i -X GET \
 "https://graph.facebook.com/v21.0/17841405309211844 \
  ?fields=business_discovery.username(bluebottle){followers_count,media_count,media{comments_count,like_count}} \
  &access_token=<YOUR_APP_USERS_INSTAGRAM_USER_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"
}