Synupv1
Schlüssel erstellen
v1Ressourcen/Posts/getBeiträge auflisten

Beiträge auflisten

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

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