Synupv1
Schlüssel erstellen
v1Ressourcen/Connections/getBoost-Konfigurationen auflisten

Boost-Konfigurationen auflisten

Liefert die gespeicherten Boost-Konfigurationen (wiederverwendbare Targeting- und Budgetvorlagen zum Boosten eines Beitrags) auf einem verbundenen Konto.

get/api/v1/connections/boost-configs
connections:read
Query-Parameter
connectionIdstringerforderlich
Das abzurufende verbundene Konto. Erforderlich. Nachschlagen mit GET /api/v1/connections.
Antwort
dataobjectoptional
boostConfigsarray of objectoptional
Die auf diesem verbundenen Konto gespeicherten Boost-Konfigurationen.
idstringoptional
Eindeutige Kennung der Boost-Konfiguration.
connectionIdstringoptional
ID des verbundenen Kontos, zu dem diese Boost-Konfiguration gehört.
adAccountIdstringoptional
ID des Werbekontos, aus dem diese Boost-Konfiguration ausgibt.
namestringoptional
Name dieser Vorlage.
platformstringoptional
Plattform, auf der diese Boost-Konfiguration läuft, passend zu ihrem verbundenen Konto.
targetingobjectoptional
Targeting-Einstellungen für diese Vorlage.
ageMinnumberoptional
Mindestalter der Zielgruppe.
ageMaxnumberoptional
Höchstalter der Zielgruppe.
gendersarray of numberoptional
Anzusprechende Geschlechter der Zielgruppe: 1 für männlich, 2 für weiblich.
geoLocationsobjectoptional
Geografisches Targeting: Länder, Regionen, Städte und/oder Postleitzahlen.
interestsarray of objectoptional
Anzusprechende Interessenkategorien.
publisherPlatformsarray of stringoptional
Auf welchen Plattform-Oberflächen die Zielgruppe angesprochen werden soll, z. B. ["facebook", "instagram"].
pageFansstring (fans | fans_of_fans)optional
Die Zielgruppe auf Personen beschränken, denen die Seite gefällt (Fans), oder zusätzlich auf deren Freunde (fans_of_fans).
dailyBudgetnumberoptional
Tagesbudget, in der kleinsten Währungseinheit der Plattform (z. B. Cent).
durationDaysnumberoptional
Wie viele Tage der Boost nach Anwendung läuft.
delayHoursnumberoptional
Stunden, die nach Veröffentlichung eines Beitrags gewartet wird, bevor er geboostet wird.
publisherPlatformsarray of stringoptional
Auf welchen Plattform-Oberflächen diese Vorlage boostet.
archivedbooleanoptional
Ob diese Vorlage archiviert wurde.
createdAtstringoptional
Wann diese Vorlage erstellt wurde, als ISO-8601-Zeitstempel.
updatedAtstringoptional
Wann diese Vorlage zuletzt aktualisiert wurde, als ISO-8601-Zeitstempel.
adAccountobjectoptional
Eine kurze Zusammenfassung des Werbekontos, aus dem diese Vorlage ausgibt, oder null.
platformAccountIdstringoptional
Die eigene Kennung der Plattform für dieses Werbekonto.
namestringoptional
Anzeigename dieses Werbekontos.
currencystringoptional
Währung, in der dieses Werbekonto abrechnet, oder null.
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.
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/connections/boost-configs
Ihr API-Schlüssel
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"
      }
    ]
  }
}