Synup
Créer une clé
v1Ressources/Paid Boosts/getList boosts

List boosts

Lists the workspace's boosts, newest first: status, whether it is deferred, budget, spend so far, the post it promotes and the control that applies. Up to 50 per page.

get/api/v1/boosts
boosts:read
Paramètres de requête
postIdstringfacultatif
Only boosts of this post.
statusstringfacultatif
Only this status, for example awaiting_publish, active, paused, stopped, cancelled, completed, rejected or error.
activeOnlybooleanfacultatif
True returns only boosts that can still be stopped or cancelled.
pageintegerfacultatif
The page number, from 1.
limitintegerfacultatif
Boosts per page, 1 to 50.
Réponse
dataobjectfacultatif
boostsarray of objectfacultatif
The boosts.
totalintegerfacultatif
How many boosts match.
pageintegerfacultatif
This page's number.
perPageintegerfacultatif
How many boosts a page holds.
hasMorebooleanfacultatif
True when there is another page.
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.
429Trop de requêtes. Réessayez après le nombre de secondes indiqué dans l'en-tête Retry-After.
get/api/v1/boosts
Votre clé API
postId
status
activeOnly
page
limit
{
  "data": {
    "boosts": [
      {
        "adRunId": "run_123",
        "adCampaignId": "camp_123",
        "postId": "post_123",
        "platform": "facebook",
        "status": "active",
        "deferred": false,
        "control": "stop_post_boost",
        "dailyBudget": 2500,
        "durationDays": 7,
        "startAt": "2026-10-12T09:00:00.000Z",
        "endAt": "2026-10-19T09:00:00.000Z",
        "createdAt": "2026-10-12T08:55:00.000Z",
        "stoppedAt": null,
        "spend": 36.2,
        "impressions": 4210,
        "clicks": 98
      }
    ],
    "total": 1,
    "page": 1,
    "perPage": 50,
    "hasMore": false
  }
}

Vous débutez avec l'API Synup ?