Synup
Schlüssel erstellen
v1Ressourcen/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
Query-Parameter
postIdstringoptional
Only boosts of this post.
statusstringoptional
Only this status, for example awaiting_publish, active, paused, stopped, cancelled, completed, rejected or error.
activeOnlybooleanoptional
True returns only boosts that can still be stopped or cancelled.
pageintegeroptional
The page number, from 1.
limitintegeroptional
Boosts per page, 1 to 50.
Antwort
dataobjectoptional
boostsarray of objectoptional
The boosts.
totalintegeroptional
How many boosts match.
pageintegeroptional
This page's number.
perPageintegeroptional
How many boosts a page holds.
hasMorebooleanoptional
True when there is another page.
Fehler
400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.
403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/boosts
Ihr API-Schlüssel
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
  }
}

Neu bei der Synup-API?