Plate-forme Instagram

Hashtag IG

Représente un hashtag Instagram.

Création

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

Lecture

GET /{ig-hashtag-id}

Renvoie les champs et les arêtes d’un hashtag IG.

Limites

Vous pouvez interroger jusqu’à 30 hashtags uniques sur une période de 7 jours consécutifs.

Conditions requises

TypeDescription

Fonctionnalités

Instagram Public Content Access

Autorisations

instagram_basic


Si le token émane d’un·e utilisateur·ice 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 de l’utilisateur·ice de l’application.

Syntaxe de la requête

GET https://graph.facebook.com/{ig-hashtag-id}
  ?fields={fields}
  &access_token={access-token}

Paramètres de chaîne de requête

Inclure les paramètres de chaîne de requête suivants pour augmenter la demande.

CléValeur

access_token
Obligatoire
Chaîne

Token d’accès pour utilisateur Instagram de l’utilisateur de l’application.

fields
Liste d’éléments séparés par une virgule

Liste des arêtes et des champs (séparés par des virgules) à renvoyer. En cas d’omission, les champs par défaut sont renvoyés.

Champs

Vous pouvez utiliser le paramètre de chaîne de requête fields pour demander les champs suivants d’un hashtag IG.

Nom du champDescription

id

ID du hashtag (inclus par défaut). Les ID sont statiques et globaux.

name

Nom du hashtag sans le symbole dièse.

Arêtes

Vous pouvez interroger les arêtes suivantes en tant que paramètres du chemin ou en utilisant le paramètre de chaîne de requête fields.

ArêteDescription

recent_media

Permet d’obtenir la liste des objets IG Media publiés avec un hashtag spécifique des photos et vidéos les plus récentes.

top_media

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

Réponse

Objet au format JSON contenant des champs demandés et par défaut.

{
  "{field}":"{value}",
  ...
}

Exemple de requête

GET https://graph.facebook.com/17841593698074073
  ?fields=id,name
  &access_token=EAADd...

Exemple de réponse

{
  "id": "17841593698074073",
  "name": "coke"
}

Mise à jour

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

Suppression

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