Synupv1
Créer une clé
v1Ressources/Connexions/getLister les configurations de boost

Lister les configurations de boost

Renvoie les configurations de boost enregistrées (préréglages réutilisables de ciblage et de budget pour booster un post) sur un compte connecté.

get/api/v1/connections/boost-configs
connections:read
Paramètres de requête
connectionIdstringobligatoire
Le compte connecté à consulter. Obligatoire. Retrouvez-le avec GET /api/v1/connections.
Réponse
dataobjectfacultatif
boostConfigsarray of objectfacultatif
Les configurations de boost enregistrées sur ce compte connecté.
idstringfacultatif
Identifiant unique de la configuration de boost.
connectionIdstringfacultatif
ID du compte connecté auquel appartient cette configuration de boost.
adAccountIdstringfacultatif
ID du compte publicitaire duquel cette configuration de boost dépense.
namestringfacultatif
Nom de ce préréglage.
platformstringfacultatif
Plateforme sur laquelle tourne cette configuration de boost, correspondant à son compte connecté.
targetingobjectfacultatif
Réglages de ciblage pour ce préréglage.
ageMinnumberfacultatif
Âge minimal de l'audience.
ageMaxnumberfacultatif
Âge maximal de l'audience.
gendersarray of numberfacultatif
Genres d'audience à cibler : 1 pour homme, 2 pour femme.
geoLocationsobjectfacultatif
Ciblage géographique : pays, régions, villes et/ou codes postaux.
interestsarray of objectfacultatif
Catégories d'intérêt à cibler.
publisherPlatformsarray of stringfacultatif
Sur quelles surfaces de plateforme cibler, par ex. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)facultatif
Restreint l'audience aux personnes qui aiment la page (fans) ou aussi à leurs amis (fans_of_fans).
dailyBudgetnumberfacultatif
Budget quotidien, dans l'unité monétaire mineure de la plateforme (par ex. les centimes).
durationDaysnumberfacultatif
Nombre de jours pendant lesquels le boost tourne une fois appliqué.
delayHoursnumberfacultatif
Heures à attendre après la publication d'un post avant de le booster.
publisherPlatformsarray of stringfacultatif
Sur quelles surfaces de plateforme ce préréglage booste.
archivedbooleanfacultatif
Si ce préréglage a été archivé.
createdAtstringfacultatif
Date de création de ce préréglage, au format horodatage ISO 8601.
updatedAtstringfacultatif
Date de dernière mise à jour de ce préréglage, au format horodatage ISO 8601.
adAccountobjectfacultatif
Un court résumé du compte publicitaire duquel ce préréglage dépense, ou null.
platformAccountIdstringfacultatif
L'identifiant propre à la plateforme pour ce compte publicitaire.
namestringfacultatif
Nom d'affichage de ce compte publicitaire.
currencystringfacultatif
Devise de facturation de ce compte publicitaire, ou null.
Erreurs
400Il manque un paramètre requis à la requête, ou elle est invalide.
401Clé API manquante, invalide, expirée ou révoquée.
403La clé n'a pas la permission requise, ou n'est pas autorisée pour ce client/établissement.
404La ressource est introuvable, ou n'appartient pas à votre agence.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/connections/boost-configs
Votre clé API
connectionId *
{
  "data": {
    "boostConfigs": [
      {
        "id": "boost_1",
        "connectionId": "conn_1",
        "adAccountId": "adacct_1",
        "name": "Local awareness — $10/day",
        "platform": "facebook",
        "targeting": {
          "ageMin": 25,
          "ageMax": 55,
          "genders": [],
          "geoLocations": {
            "countries": [],
            "regions": [],
            "cities": [],
            "zips": []
          },
          "interests": [],
          "publisherPlatforms": [
            "facebook"
          ]
        },
        "dailyBudget": 10,
        "durationDays": 7,
        "delayHours": 0,
        "publisherPlatforms": [
          "facebook"
        ],
        "archived": false,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-01-15T10:00:00.000Z"
      }
    ]
  }
}