Recherche de hashtags

Trouvez un objet IG Media qui a été identifié par des hashtags spécifiques.

Limitations

• Vous pouvez interroger jusqu’à 30 hashtags uniques au nom d’un compte Instagram Business ou Creator sur une période continue de sept jours. Dès qu’une requête portant sur un hashtag est lancée, elle est décomptée du nombre maximal autorisé de requêtes sur une période de sept jours. Les requêtes ultérieures effectuées pour le même hashtag au cours de cette période ne seront pas décomptées du nombre maximal autorisé, et le minuteur de sept jours lancé lors de la requête initiale ne sera pas réinitialisé.
• Vous ne pouvez pas ajouter de commentaires aux objets multimédias identifiés par un hashtag qui sont découverts via l’API.
• Les hashtags ne sont pas pris en charge dans les stories.
• Les emojis ne sont pas pris en charge dans les requêtes portant sur des hashtags.
• L’API renvoie une erreur générique pour toutes les requêtes incluant des hashtags que nous considérons comme présentant un caractère sensible ou offensant.

Conditions requises

Pour pouvoir utiliser cette API, vous devez la soumettre au Contrôle app et demander les approbations suivantes :

• Fonctionnalité Instagram Public Content Access
• Autorisation instagram_basic

Points de terminaison

L’API Hashtag Search se compose des nœuds et arêtes suivants :

• GET /ig_hashtag_search : permet d’obtenir l’ID de nœud d’un hashtag spécifique
• GET /{ig-hashtag-id} : permet d’obtenir des données sur un hashtag
• GET /{ig-hashtag-id}/top_media : permet d’obtenir les photos et vidéos les plus populaires associées à un hashtag spécifique
• GET /{ig-hashtag-id}/recent_media : permet d’obtenir les photos et vidéos les plus récentes associées à un hashtag spécifiques
• GET /{ig-user-id}/recently_searched_hashtags : permet de déterminer les hashtags uniques recherchés par un compte Instagram Business ou Creator pendant la semaine en cours

Pour plus d’informations sur les champs pris en charge, les paramètres et les conditions d’utilisation, consultez la documentation de référence sur le point de terminaison.

Usages courants

Obtenir des médias identifiés par un hashtag

Pour obtenir toutes les photos et vidéos associées à un hashtag spécifique, commencez par utiliser le point de terminaison /ig_hashtag_search et par inclure le hashtag et l’ID du compte Instagram Business ou Creator qui est à l’origine de la requête. Par exemple, si la requête est effectuée au nom du compte Instagram Business dont l’ID est 17841405309211844, vous pouvez obtenir l’ID du hashtag « #coke » en lançant la requête suivante :

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

L’ID de nœud du hashtag « #coke » est alors renvoyé :

{
  "id" : "17873440459141021"
}

Une fois l’ID de hashtag obtenu (17873440459141021), vous pouvez interroger son arête /top_media ou /recent_media et inclure l’ID du compte Business pour obtenir une collection d’objets multimédias associés au hashtag « #coke ». Par exemple :

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

Une réponse similaire à celle-ci serait renvoyée :

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}