Skip to main content
GET
Récupérez les annonces qui ont été sponsorisées pour une publication Instagram spécifique. Cet endpoint des annonces sponsorisées fournit des informations détaillées sur les annonces sponsorisées, notamment le statut, les dépenses actuelles, les indicateurs de performance (statistiques) et les liens de prévisualisation.
  • Les indicateurs sont des totaux en temps réel pour les annonces. Si vous avez besoin de données historiques, utilisez l’endpoint get ad history.
  • L’URL previewLink vous permet de partager l’aperçu de l’annonce avec vos collègues, afin qu’ils puissent voir l’annonce pendant 24 heures dans les différents formats Instagram. Les vues de l’annonce par vos collègues ne seront pas comptabilisées dans vos dépenses publicitaires.

Paramètres d’en-tête

Paramètres de requête

number
requis
Récupérer toutes les annonces sous l’ID du compte.Requis si adId, socialPostId ou postId n’est pas défini.
string
requis
Récupérer une annonce avec l’ID de l’annonce.Requis si accountId, socialPostId ou postId n’est pas défini.
string
requis
Récupérer les annonces avec l’ID de publication sociale Instagram.Requis si accountId, adId ou postId n’est pas défini.
number
défaut:25
Récupérer un maximum de limit annonces. Le maximum est 300 ; les valeurs supérieures sont plafonnées à 300.
string
requis
Récupérer les annonces avec l’ID de publication Ayrshare.Requis si accountId, adId ou socialPostId n’est pas défini.
string
défaut:"all"
Filtrer les annonces par statut. Omettez ce paramètre pour renvoyer les annonces de tous les statuts. Les valeurs valides sont :
  • active
  • paused
  • deleted
  • archived