Synupv1
Schlüssel erstellen
v1Ressourcen/Posts/getBeitrag abrufen

Beitrag abrufen

Liefert einen einzelnen Beitrag samt seiner Übermittlungsleistung je Plattform.

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
      }
    ]
  }
}