Synupv1
Schlüssel erstellen
v1Ressourcen/Posts

Posts

Erstellen, Lesen und Veröffentlichen von Social- und Google-Unternehmensprofil-Beiträgen.

Liefert Beiträge für einen Standort, zuletzt erstellte zuerst, mit dem Übermittlungsstatus je Plattform und zusammengefassten Kennzahlen.

Beiträge auflisten

get/api/v1/posts
posts:read
Query-Parameter
locationIdstringerforderlich
Der Standort, für den Beiträge aufgelistet werden sollen. Erforderlich.
platformstringoptional
Ergebnisse auf Beiträge beschränken, die an diese Plattform übermittelt wurden.
typestring (announcement | event | offer)optional
Ergebnisse auf einen Beitragstyp beschränken.
statusstringoptional
Ergebnisse auf einen Beitragsstatus beschränken.
fromstringoptional
Nur Beiträge einschließen, die an oder nach diesem Datum erstellt wurden.
tostringoptional
Nur Beiträge einschließen, die an oder vor diesem Datum erstellt wurden.
searchstringoptional
Abgleich mit dem Namen des Beitrags, ohne Beachtung der Groß-/Kleinschreibung.
pageintegeroptional
Seitenzahl, beginnend bei 1. Standardmäßig 1.
perPageintegeroptional
Ergebnisse pro Seite, bis zu 50. Standardmäßig 20.
Antwort
dataobjectoptional
rowsarray of objectoptional
Die passenden Beiträge.
idstringoptional
Eindeutige Kennung des Beitrags.
namestringoptional
Interner Name/Bezeichnung des Beitrags.
typestringoptional
Beitragstyp: announcement, event oder offer.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
postDatestringoptional
Das geplante oder erstellte Datum des Beitrags, als ISO-8601-Zeitstempel.
platformsarray of stringoptional
Die Plattformen, auf die dieser Beitrag abzielt.
firstMediaUrlstringoptional
URL des ersten Medienelements des Beitrags, oder null.
firstMediaTypestringoptional
Typ des ersten Medienelements des Beitrags (image oder video), oder null.
submissionsarray of objectoptional
Übermittlungsstatus je Plattform für diesen Beitrag.
platformstringoptional
Die Plattform, für die diese Zeile steht.
statusstringoptional
Status dieser Plattformübermittlung: pending, active, error oder deleted.
postLinkstringoptional
Öffentliche URL des veröffentlichten Beitrags auf dieser Plattform, oder null.
reviewStatestringoptional
Google-Moderationsstatus (processing, live, rejected), oder null für andere Plattformen.
errorMessagestringoptional
Fehlermeldung, falls diese Übermittlung fehlgeschlagen ist, oder null.
messagePreviewstringoptional
Die ersten 140 Zeichen des Beitragstexts, oder null.
viewsnumberoptional
Gesamtzahl der Aufrufe, oder null, falls noch nicht verfügbar.
clicksnumberoptional
Gesamtzahl der Klicks, oder null, falls noch nicht verfügbar.
errorMsgstringoptional
Fehlermeldung der ersten fehlgeschlagenen Übermittlung, oder null.
deletedOnstringoptional
Wann dieser Beitrag zurückgezogen wurde, als ISO-8601-Zeitstempel, oder null.
totalnumberoptional
Gesamtzahl der passenden Beiträge.
statsobjectoptional
Zusammengefasste Kennzahlen über die passenden Beiträge.
totalPostsnumberoptional
Anzahl der passenden Beiträge.
totalViewsnumberoptional
Gesamtzahl der Aufrufe über die passenden Beiträge, oder null.
totalClicksnumberoptional
Gesamtzahl der Klicks über die passenden Beiträge, oder null.
totalEngagementnumberoptional
Reaktionen, Shares und Kommentare zusammen über die passenden Beiträge.
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/posts
Ihr API-Schlüssel
locationId *
platform
type
status
from
to
search
page
perPage
{
  "data": {
    "rows": [
      {
        "id": "cm_post_abc123",
        "name": "Fall Special Announcement",
        "type": "announcement",
        "status": "scheduled",
        "postDate": "2026-02-10T15:00:00.000Z",
        "platforms": [
          "google",
          "facebook"
        ],
        "firstMediaUrl": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "firstMediaType": "image",
        "submissions": [
          {
            "platform": "google",
            "status": "pending",
            "postLink": null,
            "reviewState": null,
            "errorMessage": null
          },
          {
            "platform": "facebook",
            "status": "pending",
            "postLink": null,
            "reviewState": null,
            "errorMessage": null
          }
        ],
        "messagePreview": "Join us this weekend for our fall special — 20% off all services!",
        "views": null,
        "clicks": null,
        "errorMsg": null,
        "deletedOn": null
      }
    ],
    "total": 1,
    "stats": {
      "totalPosts": 12,
      "totalViews": 4300,
      "totalClicks": 210,
      "totalEngagement": 96
    }
  }
}
v1Ressourcen/Posts/postBeitrag erstellen

Erstellt einen Beitrag für einen Standort oder Kunden und übermittelt ihn an die ausgewählten Plattformen. Dies veröffentlicht echten Inhalt: Sofern nicht scheduledFor gesetzt oder draft true ist, geht der Beitrag sofort auf seinen Zielplattformen live. Eine angeforderte Plattform ohne aktive Verbindung, oder ein Beitrag, dem ein für die Veröffentlichung erforderliches Feld fehlt, lässt den Aufruf nie fehlschlagen — der Inhalt wird stattdessen als Entwurf gespeichert; siehe das Antwortschema dafür, wie das gemeldet wird.

Beitrag erstellen

post/api/v1/posts
posts:write
Anfragetext
locationIdstringoptional
Der Standort, an den gepostet werden soll. Geben Sie diesen oder clientId an.
clientIdstringoptional
Der Kunde, für den auf Markenebene gepostet werden soll. Geben Sie diesen oder locationId an.
namestringerforderlich
Interner Name/Bezeichnung des Beitrags. Erforderlich, nicht leer.
postTypestring (announcement | event | offer)erforderlich
Beitragstyp. event und offer sind Google-exklusiv.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)erforderlich
Zielplattformen. Mindestens eine ist erforderlich.
connectionIdsarray of stringoptional
Explizite Verbindungs-IDs, über die veröffentlicht werden soll, anstatt Plattformen zu Verbindungen aufzulösen.
messageGooglestringoptional
Text für Google. Erforderlich, wenn google ausgewählt ist, außer bei draft.
messageFacebookstringoptional
Gemeinsam genutzter Social-Text für jede ausgewählte Nicht-Google-Plattform. Erforderlich, außer bei draft.
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)optional
Call-to-Action-Typ.
ctaUrlstringoptional
Ziel-URL des Call-to-Action.
mediaUrlsarray of objectoptional
Anzuhängende Medien, ein Eintrag je Plattform-Anhang.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Titel des Events oder Angebots. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventStartAtstringoptional
Start des Events oder Angebots, als ISO-8601-Zeitstempel. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventEndAtstringoptional
Ende des Events oder Angebots, als ISO-8601-Zeitstempel. Muss nach dem Start liegen.
offerTermsstringoptional
Bedingungen des Angebots.
offerCouponCodestringoptional
Gutscheincode des Angebots.
offerRedeemUrlstringoptional
Einlöse-URL des Angebots.
scheduledForstringoptional
Zu diesem zukünftigen ISO-8601-Zeitstempel veröffentlichen, anstatt sofort.
draftbooleanoptional
Ohne Veröffentlichung speichern. Überspringt Pflichtfeld-Prüfungen; strukturelle Prüfungen (Limits, Medienregeln) gelten weiterhin.
Antwort
dataobjectoptional
Eine angeforderte Plattform ohne aktive Verbindung, oder ein Pflichtfeld, das der Beitrag benötigt, bevor er live gehen kann, lässt diesen Aufruf nie fehlschlagen — der Beitrag wird trotzdem gespeichert. Liegt eine dieser Lücken vor, ist status "no_connection" oder "incomplete", und der Beitrag liegt darunter als post.{id,status}; bei einer sauberen Veröffentlichung beschreiben id/status auf oberster Ebene den Beitrag direkt.
idstringoptional
Eindeutige Kennung des Beitrags.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
missingFieldsarray of stringoptional
Felder, die vor der Veröffentlichung dieses Beitrags noch benötigt werden, falls vorhanden.
missingPlatformsarray of stringoptional
Angeforderte Plattformen ohne aktive Verbindung, falls vorhanden.
scopestring (location | client)optional
Ob die Verbindungs-/Feld-Lücke auf Standort- oder Kundenebene gilt.
postobjectoptional
Der erstellte oder aktualisierte Beitrag.
idstringoptional
Eindeutige Kennung des Beitrags.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/posts
Ihr API-Schlüssel
Anfragetext*
{
  "data": {
    "id": "cm_post_abc123",
    "status": "scheduled"
  }
}
v1Ressourcen/Posts/getBeitragsanalysen abrufen

Liefert eine zusammengefasste Interaktionsanalyse — Gesamtsummen, eine Aufschlüsselung je Plattform, Verlaufsreihen und Top-Beiträge — über die Marken-Plattformverbindungen eines Kunden hinweg.

Beitragsanalysen abrufen

get/api/v1/posts/analytics
posts:read
Query-Parameter
clientIdstringerforderlich
Der zusammenzufassende Kunde. Erforderlich.
fromstringoptional
Beginn des Berichtszeitraums. Standardmäßig vor 30 Tagen.
tostringoptional
Ende des Berichtszeitraums. Standardmäßig jetzt.
Antwort
dataobjectoptional
summaryobjectoptional
Interaktions-Gesamtwerte für den aktuellen Zeitraum.
totalPostsnumberoptional
Anzahl der Beiträge in diesem Zeitraum.
totalViewsnumberoptional
Gesamtzahl der Aufrufe in diesem Zeitraum.
totalReactionsnumberoptional
Gesamtzahl der Reaktionen in diesem Zeitraum.
totalSharesnumberoptional
Gesamtzahl der Shares in diesem Zeitraum.
totalCommentsnumberoptional
Gesamtzahl der Kommentare in diesem Zeitraum.
periodDaysnumberoptional
Länge des Berichtszeitraums, in Tagen.
prevSummaryobjectoptional
Interaktions-Gesamtwerte für den unmittelbar vorherigen, gleich langen Zeitraum, für den Delta-Vergleich.
totalPostsnumberoptional
Anzahl der Beiträge in diesem Zeitraum.
totalViewsnumberoptional
Gesamtzahl der Aufrufe in diesem Zeitraum.
totalReactionsnumberoptional
Gesamtzahl der Reaktionen in diesem Zeitraum.
totalSharesnumberoptional
Gesamtzahl der Shares in diesem Zeitraum.
totalCommentsnumberoptional
Gesamtzahl der Kommentare in diesem Zeitraum.
byPlatformarray of objectoptional
Interaktions-Gesamtwerte, aufgeschlüsselt nach Plattform, für diesen Zeitraum.
platformstringoptional
Die Plattform, für die diese Zeile steht.
labelstringoptional
Anzeigename der Plattform.
totalPostsnumberoptional
Anzahl der Beiträge in diesem Zeitraum.
totalViewsnumberoptional
Gesamtzahl der Aufrufe in diesem Zeitraum.
totalReactionsnumberoptional
Gesamtzahl der Reaktionen in diesem Zeitraum.
totalSharesnumberoptional
Gesamtzahl der Shares in diesem Zeitraum.
totalCommentsnumberoptional
Gesamtzahl der Kommentare in diesem Zeitraum.
prevByPlatformarray of objectoptional
Interaktions-Gesamtwerte, aufgeschlüsselt nach Plattform, für den vorherigen Zeitraum.
platformstringoptional
Die Plattform, für die diese Zeile steht.
labelstringoptional
Anzeigename der Plattform.
totalPostsnumberoptional
Anzahl der Beiträge in diesem Zeitraum.
totalViewsnumberoptional
Gesamtzahl der Aufrufe in diesem Zeitraum.
totalReactionsnumberoptional
Gesamtzahl der Reaktionen in diesem Zeitraum.
totalSharesnumberoptional
Gesamtzahl der Shares in diesem Zeitraum.
totalCommentsnumberoptional
Gesamtzahl der Kommentare in diesem Zeitraum.
trendobjectoptional
Tägliche Aufrufzahlen je Plattform über den Zeitraum.
datesarray of stringoptional
Die von diesem Trend abgedeckten Daten, als YYYY-MM-DD-Zeichenfolgen.
seriesarray of objectoptional
Ein Eintrag je Plattform.
platformstringoptional
Die Plattform, für die diese Zeile steht.
labelstringoptional
Anzeigename der Plattform.
valuesarray of numberoptional
Ein Wert je Datum in dates, in derselben Reihenfolge.
engagementTrendobjectoptional
Tägliche Aufrufe, Reaktionen, Shares, Kommentare und Reichweite je Plattform über den Zeitraum.
datesarray of stringoptional
Die von diesem Trend abgedeckten Daten, als YYYY-MM-DD-Zeichenfolgen.
seriesarray of objectoptional
Ein Eintrag je Plattform.
platformstringoptional
Die Plattform, für die diese Zeile steht.
labelstringoptional
Anzeigename der Plattform.
viewsarray of numberoptional
reactionsarray of numberoptional
sharesarray of numberoptional
commentsarray of numberoptional
reacharray of numberoptional
Tägliche Reichweitenwerte, in derselben Reihenfolge wie dates.
postsTrendobjectoptional
Tägliche Anzahl an Beitragsübermittlungen je Plattform über den Zeitraum.
datesarray of stringoptional
Die von diesem Trend abgedeckten Daten, als YYYY-MM-DD-Zeichenfolgen.
seriesarray of objectoptional
Ein Eintrag je Plattform.
platformstringoptional
Die Plattform, für die diese Zeile steht.
labelstringoptional
Anzeigename der Plattform.
valuesarray of numberoptional
Ein Wert je Datum in dates, in derselben Reihenfolge.
allPostsarray of objectoptional
Die einzelnen Übermittlungen, aus denen dieses Rollup aufgebaut ist, sortiert nach Aufrufen.
submissionIdstringoptional
Eindeutige Kennung der Plattformübermittlung.
platformstringoptional
Die Plattform, für die diese Zeile steht.
platformPostIdstringoptional
Die eigene ID der Plattform für den veröffentlichten Beitrag, oder null.
postLinkstringoptional
Öffentliche URL des veröffentlichten Beitrags auf dieser Plattform, oder null.
publishedAtstringoptional
Wann diese Übermittlung veröffentlicht wurde, als ISO-8601-Zeitstempel, oder null.
contentPreviewstringoptional
Der Name des Beitrags, zur Anzeige.
totalViewsnumberoptional
Gesamtzahl der Aufrufe in diesem Zeitraum.
totalReactionsnumberoptional
Gesamtzahl der Reaktionen in diesem Zeitraum.
totalSharesnumberoptional
Gesamtzahl der Shares in diesem Zeitraum.
totalCommentsnumberoptional
Gesamtzahl der Kommentare in diesem Zeitraum.
totalReachnumberoptional
Gesamtreichweite für diese Übermittlung.
engRatenumberoptional
Interaktionsrate — Reaktionen plus Shares plus Kommentare, als Prozentsatz der Aufrufe — oder null, falls es noch keine Aufrufe gibt.
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/posts/analytics
Ihr API-Schlüssel
clientId *
from
to
{
  "data": {
    "summary": {
      "totalPosts": 18,
      "totalViews": 5400,
      "totalReactions": 320,
      "totalShares": 44,
      "totalComments": 61,
      "periodDays": 30
    },
    "prevSummary": {
      "totalPosts": 14,
      "totalViews": 4100,
      "totalReactions": 260,
      "totalShares": 30,
      "totalComments": 48
    },
    "byPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 10,
        "totalViews": 3200,
        "totalReactions": 210,
        "totalShares": 30,
        "totalComments": 40
      },
      {
        "platform": "instagram",
        "label": "Instagram",
        "totalPosts": 8,
        "totalViews": 2200,
        "totalReactions": 110,
        "totalShares": 14,
        "totalComments": 21
      }
    ],
    "prevByPlatform": [
      {
        "platform": "facebook",
        "label": "Facebook",
        "totalPosts": 8,
        "totalViews": 2500,
        "totalReactions": 170,
        "totalShares": 20,
        "totalComments": 32
      }
    ],
    "trend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            4,
            6
          ]
        }
      ]
    },
    "engagementTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "views": [
            180,
            210
          ],
          "reactions": [
            12,
            15
          ],
          "shares": [
            2,
            3
          ],
          "comments": [
            4,
            5
          ],
          "reach": [
            900,
            1100
          ]
        }
      ]
    },
    "postsTrend": {
      "dates": [
        "2026-01-15",
        "2026-01-16"
      ],
      "series": [
        {
          "platform": "facebook",
          "label": "Facebook",
          "values": [
            1,
            2
          ]
        }
      ]
    },
    "allPosts": [
      {
        "submissionId": "cm_sub_xyz789",
        "platform": "facebook",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "publishedAt": "2026-01-16T14:00:00.000Z",
        "contentPreview": "Join us this weekend for our fall special — 20% off all services!",
        "totalViews": 890,
        "totalReactions": 42,
        "totalShares": 6,
        "totalComments": 9,
        "totalReach": 1450,
        "engRate": 0.064
      }
    ]
  }
}
v1Ressourcen/Posts/getBeitrag abrufen

Liefert einen einzelnen Beitrag samt seiner Übermittlungsleistung je Plattform.

Beitrag abrufen

get/api/v1/posts/{id}
posts:read
Query-Parameter
idstringerforderlich
Der abzurufende Beitrag.
Antwort
dataobjectoptional
Es können weitere interne Felder vorhanden sein, die nicht Teil des stabilen Vertrags sind — verlassen Sie sich nur auf die hier dokumentierten Felder.
idstringoptional
Eindeutige Kennung des Beitrags.
namestringoptional
Interner Name/Bezeichnung des Beitrags.
typestringoptional
Beitragstyp (Duplikat von postType, aus Gründen der Abwärtskompatibilität erhalten).
statusstring (draft | scheduled | active | error)optional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
postTypestring (announcement | event | offer)optional
Beitragstyp: announcement, event oder offer.
clientIdstringoptional
ID des Kunden, zu dem dieser Beitrag gehört.
locationIdstringoptional
ID des Standorts, zu dem dieser Beitrag gehört, oder null bei einem markenweiten Beitrag.
locationNamestringoptional
Anzeigename des Standorts dieses Beitrags, oder null.
clientNamestringoptional
Anzeigename des Kunden dieses Beitrags, oder null.
platformsarray of stringoptional
Die Plattformen, auf die dieser Beitrag abzielt.
messageGooglestringoptional
Für Google verwendeter Text, oder null.
messageFacebookstringoptional
Gemeinsam genutzter Social-Text für alle Nicht-Google-Plattformen, oder null.
ctaTypestringoptional
Call-to-Action-Typ, oder null.
ctaUrlstringoptional
Call-to-Action-URL, oder null.
ctaUrlFacebookstringoptional
Facebook-spezifische Call-to-Action-URL, oder null.
xThreadbooleanoptional
Ob der X-Thread-Modus aktiviert ist (umgeht das 280-Zeichen-Limit).
ctaJsonobjectoptional
Rohe plattformspezifische Call-to-Action- und Targeting-Einstellungen.
mediaUrlsarray of objectoptional
An den Beitrag angehängte Medien, ein Eintrag je Plattform-Anhang.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Titel des Events oder Angebots, oder null.
eventStartAtstringoptional
Start des Events oder Angebots, als ISO-8601-Zeitstempel, oder null.
eventEndAtstringoptional
Ende des Events oder Angebots, als ISO-8601-Zeitstempel, oder null.
offerTermsstringoptional
Bedingungen des Angebots, oder null.
offerCouponCodestringoptional
Gutscheincode des Angebots, oder null.
offerRedeemUrlstringoptional
Einlöse-URL des Angebots, oder null.
scheduledForstringoptional
Wann der Beitrag veröffentlicht werden soll, als ISO-8601-Zeitstempel, oder null für sofortige Veröffentlichung.
createdAtstringoptional
Zeitpunkt der Erstellung des Beitrags, als ISO-8601-Zeitstempel.
performancearray of objectoptional
Übermittlungsleistung je Plattform für diesen Beitrag.
submissionIdstringoptional
Eindeutige Kennung der Plattformübermittlung.
connectionIdstringoptional
ID der Verbindung, über die diese Übermittlung gesendet wurde.
sitestringoptional
Die Plattform, auf die diese Übermittlung abzielt.
viewsnumberoptional
Gesamtzahl der Aufrufe, oder null, falls noch nicht verfügbar.
clicksnumberoptional
Gesamtzahl der Klicks, oder null, falls noch nicht verfügbar.
reactionsnumberoptional
Gesamtzahl der Reaktionen.
sharesnumberoptional
Gesamtzahl der Shares.
commentsnumberoptional
Gesamtzahl der Kommentare.
statusstringoptional
Status dieser Plattformübermittlung: pending, active, error oder deleted.
platformPostIdstringoptional
Die eigene ID der Plattform für den veröffentlichten Beitrag, oder null.
postLinkstringoptional
Öffentliche URL des veröffentlichten Beitrags auf dieser Plattform, oder null.
reviewStatestringoptional
Google-Moderationsstatus (processing, live, rejected), oder null für andere Plattformen.
errorMessagestringoptional
Fehlermeldung, falls diese Übermittlung fehlgeschlagen ist, oder null.
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/posts/{id}
Ihr API-Schlüssel
id *
{
  "data": {
    "id": "cm_post_abc123",
    "name": "Fall Special Announcement",
    "type": "announcement",
    "status": "scheduled",
    "postType": "announcement",
    "clientId": "cm_client_1",
    "locationId": "cm_loc_1",
    "locationName": "Acme Dental — Downtown",
    "clientName": "Acme Dental",
    "platforms": [
      "google",
      "facebook"
    ],
    "messageGoogle": "Join us this weekend for our fall special — 20% off all services!",
    "messageFacebook": "Join us this weekend for our fall special — 20% off all services!",
    "ctaType": "learn_more",
    "ctaUrl": "https://acmedental.example.com/fall-special",
    "ctaUrlFacebook": null,
    "xThread": false,
    "ctaJson": {
      "ctaType": "learn_more",
      "ctaUrl": "https://acmedental.example.com/fall-special",
      "ctaUrlFacebook": null,
      "xThread": false
    },
    "mediaUrls": [
      {
        "url": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "platform": "facebook",
        "type": "image"
      }
    ],
    "eventTitle": null,
    "eventStartAt": null,
    "eventEndAt": null,
    "offerTerms": null,
    "offerCouponCode": null,
    "offerRedeemUrl": null,
    "scheduledFor": "2026-02-10T15:00:00.000Z",
    "createdAt": "2026-01-20T09:12:00.000Z",
    "performance": [
      {
        "submissionId": "cm_sub_xyz789",
        "connectionId": "cm_conn_1",
        "site": "facebook",
        "views": 890,
        "clicks": null,
        "reactions": 42,
        "shares": 6,
        "comments": 9,
        "status": "active",
        "platformPostId": "1234567890",
        "postLink": "https://www.facebook.com/1234567890",
        "reviewState": null,
        "errorMessage": null
      }
    ]
  }
}
v1Ressourcen/Posts/patchBeitrag aktualisieren

Aktualisiert einen bearbeitbaren Beitrag (draft, scheduled, error oder active) und gleicht seine Plattformübermittlungen entsprechend ab. Ist der Beitrag nicht geplant und nicht als Entwurf gespeichert, kann dies bereits Live-Inhalte auf seinen Plattformen veröffentlichen oder ändern.

Beitrag aktualisieren

patch/api/v1/posts/{id}
posts:write
Query-Parameter
idstringerforderlich
Der zu aktualisierende Beitrag.
Anfragetext
locationIdstringoptional
Der Standort, an den gepostet werden soll. Geben Sie diesen oder clientId an.
clientIdstringoptional
Der Kunde, für den auf Markenebene gepostet werden soll. Geben Sie diesen oder locationId an.
namestringoptional
Interner Name/Bezeichnung des Beitrags. Erforderlich, nicht leer.
postTypestring (announcement | event | offer)optional
Beitragstyp. event und offer sind Google-exklusiv.
platformsarray of string (google | facebook | instagram | x | linkedin | pinterest | mastodon | bluesky | threads | tiktok)optional
Zielplattformen. Mindestens eine ist erforderlich.
connectionIdsarray of stringoptional
Explizite Verbindungs-IDs, über die veröffentlicht werden soll, anstatt Plattformen zu Verbindungen aufzulösen.
messageGooglestringoptional
Text für Google. Erforderlich, wenn google ausgewählt ist, außer bei draft.
messageFacebookstringoptional
Gemeinsam genutzter Social-Text für jede ausgewählte Nicht-Google-Plattform. Erforderlich, außer bei draft.
ctaTypestring (learn_more | sign_up | order_online | book | buy | call_now)optional
Call-to-Action-Typ.
ctaUrlstringoptional
Ziel-URL des Call-to-Action.
mediaUrlsarray of objectoptional
Anzuhängende Medien, ein Eintrag je Plattform-Anhang.
urlstringoptional
platformstringoptional
typestring (image | video)optional
eventTitlestringoptional
Titel des Events oder Angebots. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventStartAtstringoptional
Start des Events oder Angebots, als ISO-8601-Zeitstempel. Erforderlich für ein Google-Event/-Angebot, außer bei draft.
eventEndAtstringoptional
Ende des Events oder Angebots, als ISO-8601-Zeitstempel. Muss nach dem Start liegen.
offerTermsstringoptional
Bedingungen des Angebots.
offerCouponCodestringoptional
Gutscheincode des Angebots.
offerRedeemUrlstringoptional
Einlöse-URL des Angebots.
scheduledForstringoptional
Zu diesem zukünftigen ISO-8601-Zeitstempel veröffentlichen, anstatt sofort.
draftbooleanoptional
Ohne Veröffentlichung speichern. Überspringt Pflichtfeld-Prüfungen; strukturelle Prüfungen (Limits, Medienregeln) gelten weiterhin.
Antwort
dataobjectoptional
Eine angeforderte Plattform ohne aktive Verbindung, oder ein Pflichtfeld, das der Beitrag benötigt, bevor er live gehen kann, lässt diesen Aufruf nie fehlschlagen — der Beitrag wird trotzdem gespeichert. Liegt eine dieser Lücken vor, ist status "no_connection" oder "incomplete", und der Beitrag liegt darunter als post.{id,status}; bei einer sauberen Veröffentlichung beschreiben id/status auf oberster Ebene den Beitrag direkt.
idstringoptional
Eindeutige Kennung des Beitrags.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
missingFieldsarray of stringoptional
Felder, die vor der Veröffentlichung dieses Beitrags noch benötigt werden, falls vorhanden.
missingPlatformsarray of stringoptional
Angeforderte Plattformen ohne aktive Verbindung, falls vorhanden.
scopestring (location | client)optional
Ob die Verbindungs-/Feld-Lücke auf Standort- oder Kundenebene gilt.
postobjectoptional
Der erstellte oder aktualisierte Beitrag.
idstringoptional
Eindeutige Kennung des Beitrags.
statusstringoptional
Lebenszyklusstatus des Beitrags: draft, scheduled, active oder error.
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
patch/api/v1/posts/{id}
Ihr API-Schlüssel
id *
Anfragetext
{
  "data": {
    "id": "cm_post_abc123",
    "name": "Fall Special Announcement (updated)",
    "type": "announcement",
    "status": "scheduled",
    "postType": "announcement",
    "clientId": "cm_client_1",
    "locationId": "cm_loc_1",
    "platforms": [
      "google",
      "facebook"
    ],
    "messageGoogle": "Join us this weekend — now 25% off all services!",
    "messageFacebook": "Join us this weekend — now 25% off all services!",
    "ctaType": "learn_more",
    "ctaUrl": "https://acmedental.example.com/fall-special",
    "ctaUrlFacebook": null,
    "xThread": false,
    "ctaJson": {
      "ctaType": "learn_more",
      "ctaUrl": "https://acmedental.example.com/fall-special",
      "ctaUrlFacebook": null,
      "xThread": false
    },
    "mediaUrls": [
      {
        "url": "https://cdn.synup.com/uploads/a1/promo.jpg",
        "platform": "facebook",
        "type": "image"
      }
    ],
    "eventTitle": null,
    "eventStartAt": null,
    "eventEndAt": null,
    "offerTerms": null,
    "offerCouponCode": null,
    "offerRedeemUrl": null,
    "scheduledFor": "2026-02-10T15:00:00.000Z",
    "createdAt": "2026-01-20T09:12:00.000Z",
    "performance": []
  }
}
v1Ressourcen/Posts/deleteBeitrag zurückziehen und löschen

Zieht einen Beitrag von jeder Plattform zurück, an die er übermittelt wurde — eine echte, sofortige Aktion, die nicht rückgängig gemacht werden kann. Erst wenn der Rückzug auf jeder Plattform erfolgreich war, verschwindet der Beitrag auch aus dieser API; schlägt eine Plattform fehl, wird nichts archiviert und der Beitrag bleibt sichtbar, damit der Fehler wiederholt werden kann. Diese API löscht den Beitragsdatensatz niemals dauerhaft.

Beitrag zurückziehen und löschen

delete/api/v1/posts/{id}
posts:write
Query-Parameter
idstringerforderlich
Der zu löschende Beitrag.
Antwort
dataobjectoptional
idstringoptional
Eindeutige Kennung des Beitrags.
okbooleanoptional
Ob jede Plattformübermittlung erfolgreich zurückgezogen wurde.
deletednumberoptional
Anzahl der erfolgreich zurückgezogenen Plattformübermittlungen.
failedarray of objectoptional
Plattformübermittlungen, deren Rückzug fehlgeschlagen ist, falls vorhanden.
connectionIdstringoptional
ID der Verbindung, deren Rückzug fehlgeschlagen ist.
platformstringoptional
Die Plattform, für die diese Zeile steht.
errorstringoptional
Fehlermeldung, die beschreibt, warum der Rückzug fehlgeschlagen ist.
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.
delete/api/v1/posts/{id}
Ihr API-Schlüssel
id *
{
  "data": {
    "id": "cm_post_abc123",
    "ok": true,
    "deleted": 2,
    "failed": []
  }
}
v1Ressourcen/Posts/postBeitrag jetzt veröffentlichen

Übermittelt einen Entwurfs- oder fehlerhaften Beitrag sofort erneut und wiederholt dabei alle ausstehenden oder fehlgeschlagenen Plattformübermittlungen. Dies sendet jetzt echten Inhalt an die verbundenen Plattformen des Beitrags.

Beitrag jetzt veröffentlichen

post/api/v1/posts/{id}/publish
posts:write
Query-Parameter
idstringerforderlich
Der zu veröffentlichende Beitrag.
Antwort
dataobjectoptional
retryingnumberoptional
Anzahl der für die Zustellung erneut eingereihten Plattformübermittlungen.
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.
422Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.
429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.
post/api/v1/posts/{id}/publish
Ihr API-Schlüssel
id *
{
  "data": {
    "retrying": 2
  }
}