v1Ressourcen/Paid Boosts/getGet a boost

Get a boost

Returns one boost by its id: status, budget, spend, the post and the control that applies.

get/api/v1/boosts/{adRunId}
boosts:read
Query-Parameter
adRunIdstringerforderlich
The boost's id, from the list or the create response.
Antwort
dataobjectoptional
adRunIdstringoptional
The boost's id.
adCampaignIdstringoptional
The ad campaign it belongs to.
postIdstringoptional
The post it promotes.
platformstringoptional
The network it runs on.
statusstringoptional
init, submitted, active, paused, stopped, cancelled, completed, rejected, error or awaiting_publish.
deferredbooleanoptional
True when it is waiting for its post to publish; nothing has been spent.
controlstringoptional
stop for a live boost, cancel for a deferred one, null once it is over.
dailyBudgetintegeroptional
The daily budget, in minor currency units.
durationDaysintegeroptional
How many days it runs.
startAtstringoptional
When spend starts, as a date-time.
endAtstringoptional
When it ends, as a date-time.
createdAtstringoptional
When the boost was created.
stoppedAtstringoptional
When it was stopped, if it was.
spendnumberoptional
What has been spent so far.
impressionsintegeroptional
Impressions so far.
clicksintegeroptional
Clicks so far.
Fehler
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.
404Die Ressource wurde nicht gefunden oder gehört nicht zu Ihrer Agentur.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
get/api/v1/boosts/{adRunId}
Ihr API-Schlüssel
adRunId *
{}

Neu bei der Synup-API?