Synup
Crear clave
v1Recursos/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
Parámetros de consulta
postIdstringopcional
Only boosts of this post.
statusstringopcional
Only this status, for example awaiting_publish, active, paused, stopped, cancelled, completed, rejected or error.
activeOnlybooleanopcional
True returns only boosts that can still be stopped or cancelled.
pageintegeropcional
The page number, from 1.
limitintegeropcional
Boosts per page, 1 to 50.
Respuesta
dataobjectopcional
boostsarray of objectopcional
The boosts.
totalintegeropcional
How many boosts match.
pageintegeropcional
This page's number.
perPageintegeropcional
How many boosts a page holds.
hasMorebooleanopcional
True when there is another page.
Errores
400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.
401La clave de API falta, es inválida, expiró o fue revocada.
403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.
429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.
get/api/v1/boosts
Su clave de 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
  }
}

¿Nuevo en la API de Synup?