Synupv1
Schlüssel erstellen
v1Ressourcen/Posts/getBeitragsanalysen abrufen

Beitragsanalysen abrufen

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

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