API Graph pour Instagram

Contenu multimédia incontournable identifié par un hashtag IG

Représente un ensemble d’objets IG Media photos et vidéos les plus populaires qui ont été identifiés par un hashtag.

La popularité est déterminée par un mélange de vues et d’interaction entre les utilisateur·ices à l’aide de la même méthodologie que celle qui détermine les meilleures publications lors de la recherche de hashtag sur www.instagram.com.

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.

Création

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

Lecture

Obtention des contenus multimédias les plus populaires identifiés par un hashtag

GET /{ig-hashtag-id}/top_media?user_id={user-id}&fields={fields}

Renvoie les objets IG Media photos et vidéos les plus populaires qui ont été identifiés par ce hashtag.

Paramètres de chaîne de requête

  • {user_id} (obligatoire) : ID du compte Instagram Business ou créateur qui effectue la requête.
  • {fields} : liste des champs que vous souhaitez voir renvoyés, séparés par une virgule. Consultez l’article Champs susceptibles d’être renvoyés.

Limites

  • Cette arête renvoie uniquement des photos et vidéos publiques.
  • Ne renvoie pas de contenus multimédias promus/boostés/publicitaires.
  • Les réponses sont paginées avec une limit maximum de 50 résultats par page.
  • Vous pouvez interroger jusqu’à 30 hashtags uniques sur une période de 7 jours.
  • Vous ne pouvez pas demander le champ username sur les objets multimédias renvoyés.
  • Ce point de terminaison ne renvoie un curseur after que pour les résultats paginés ; le curseur before ne sera pas inclus. De plus, la valeur du curseur after restera la même pour chaque page, mais elle pourra toujours être utilisée pour obtenir la page de résultats suivante dans l’ensemble de résultats.

Conditions requises

TypeDescription

Fonctionnalités

Instagram Public Content Access

Autorisations

instagram_basic


Si le token émane d’un utilisateur 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, business_management ou pages_read_engagement.

Tokens

Token d’accès utilisateur provenant d’un utilisateur Facebook qui a été approuvé pour les tâches sur la Page Facebook connectée.

Réponse

Groupe d’objets IG Media. Les résultats en surplus seront paginés.

Champs susceptibles d’être renvoyés

Vous pouvez utiliser le paramètre fields pour demander les champs suivants sur les objets de contenu multimédia renvoyés :

  • caption
  • children (renvoyé uniquement pour un objet IG Media de type Album)
  • comments_count
  • id
  • like_count (Appels v10.0 et antérieurs : la valeur est 0 si le propriétaire du contenu multimédia possède des mentions J’aime masquées. Appels v11.0 et ultérieurs : le champ est omis si le propriétaire du contenu multimédia possède des mentions J’aime masquées.)
  • media_type
  • media_url (non renvoyé pour un objet IG Media de type Album)
  • permalink
  • timestamp (disponible uniquement sur les versions 7.0 et ultérieures)

Exemple de requête

GET graph.facebook.com/17873440459141021/top_media
  ?user_id=17841405309211844
  &fields=id,media_type,comments_count,like_count

Exemple de réponse

{
  "data": [
    {
      "id": "17880997618081620",
      "media_type": "IMAGE",
      "comments_count": 84,
      "like_count": 177
    },
    {
      "id": "17871527143187462"
      "media_type": "IMAGE",
      "comments_count": 24,
      "like_count": 57
    },
    {       
      "id": "17896450804038745"
      "media_type": "IMAGE",
      "comments_count": 19,
      "like_count": 36
    },
    ... // Results truncated for clarity
  ],
  "paging":
    {
      "cursors":
        {
          "after": "NTAyYmE4..."
        },
      "next": "https://graph.facebook.com/..."
    }
}

Mise à jour

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

Suppression

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