Analyse-APIAPI

Lies die Metriken jedes Netzwerks von einem Endpunkt

FoPost sammelt Performance-Daten von jedem verbundenen Konto und liefert sie in einem einheitlichen Format zurück. Rufe eine Workspace-Übersicht ab, geh in einen Beitrag hinein oder verfolge ein Konto über die Zeit, und leite alles in dein Reporting weiter.

API-Schlüssel holen Doku lesen

GET /v1/analytics/overview

curl "https://api.fopost.com/v1/analytics/overview?workspace_id=9b2f6c1e-...&days=30" \
  -H "X-API-Key: $API_KEY"

{
  "total_accounts": 6,
  "total_followers": 42810,
  "total_posts": 86,
  "total_engagement": 9127,
  "total_impressions": 184320,
  "total_reach": 121904,
  "engagement_rate": 0.0749,
  "deltas": { "followers": 2.89, "posts": 12.5 },
  "today_stats": { "posts": 3, "follower_change": 41, "engagement": 312 },
  "platforms": [{ "platform": "linkedin", "accounts": 2, "followers": 18402 }]
}

Normalisierte Metriken

Impressionen, Engagement und Follower nutzen in jedem Netzwerk dieselben Feldnamen.

Drei Ebenen

Workspace-Übersicht, ein Beitrag oder ein Konto.

Nur-Lese-Scope

Ein Schlüssel nur mit dem Scope analytics kann Zahlen lesen und sonst nichts.

Übersicht

Ein Aufruf für den Monatsbericht

Der Overview-Endpunkt summiert einen Workspace über einen Zeitraum: Gesamtwerte für Impressionen, Engagements, Follower-Veränderung und veröffentlichte Beiträge. Eine Wochenübersicht oder ein Kundenbericht ist damit ein Request und eine Vorlage.

Analytics-Referenz lesen

Verbundene Konten aller Netzwerke in einem Workspace

Zeiträume

Übergib days für ein rückblickendes Fenster von bis zu 365 Tagen. Die Deltas vergleichen es mit dem Fenster davor.

Nach Konto filtern

Grenze die Übersicht auf ein Konto ein, wenn ein Kunde nach einem Kanal fragt.

Pro Workspace

Agenturschlüssel gelten pro Kunden-Workspace, Berichte vermischen sich also nie.

Pro Beitrag

Finde heraus, welcher Beitrag die Arbeit geleistet hat

Jeder Beitrag, den du über die API erstellst, behält seine ID, und über diese ID liest du die Metriken aus jedem Netzwerk aus, in dem er gelandet ist. Verknüpfe sie mit deinen eigenen Kampagnendaten oder bewerte die Beiträge des Monats und sieh, was du wiederholen solltest.

Metriken pro Beitrag ansehen

GET /v1/posts/:id/analytics

curl "https://api.fopost.com/v1/posts/7d3e0a52-.../analytics" \
  -H "X-API-Key: $API_KEY"

{
  "post_id": "7d3e0a52-...",
  "totals": { "impressions": 21050, "reach": 15230, "engagements": 1374, "likes": 501, "comments": 60, "shares": 71, "reposts": 0, "clicks": 721, "saves": 21, "video_views": 0, "follows": 12 },
  "platforms": [
    { "platform": "linkedin", "username": "yourbrand", "external_post_id": "urn:li:share:7301...", "permalink": "https://linkedin.com/feed/update/...", "metrics": { "impressions": 12840, "likes": 311, "comments": 42, "shares": 27, "clicks": 508 } },
    { "platform": "twitter", "username": "yourbrand", "external_post_id": "1830...", "permalink": "https://x.com/...", "metrics": { "impressions": 8210, "likes": 190, "comments": 18, "shares": 44, "clicks": 213 } }
  ],
  "last_fetched_at": "2026-09-02T09:00:00Z"
}

Aufschlüsselung pro Konto

Ein Beitrag, eine Zeile pro Netzwerk, damit du siehst, welcher Kanal ihn getragen hat.

Klicks und Permalinks

Link-Klicks und der Live-Permalink kommen gleich mit den Zahlen.

Nach Label gruppieren

Liste zuerst Beiträge nach Label auf und lies dann die Metriken für die Gruppe aus.

Pro Konto

Verfolge das Wachstum jedes Kanals über die Zeit

Der Konto-Endpunkt liefert eine Reihe von Snapshots für Follower-Zahl, Reichweite und Profilaufrufe. Speise sie in deine eigenen Diagramme ein, lass dich bei einem Rückgang warnen oder zeige einem Kunden die steigende Kurve neben den Beiträgen, die sie bewegt haben.

Jetzt bauen

GET /v1/accounts/:id/analytics

curl "https://api.fopost.com/v1/accounts/4a71d80b-.../analytics?limit=7" \
  -H "X-API-Key: $API_KEY"

{
  "account_id": "4a71d80b-...",
  "platform": "linkedin",
  "username": "yourbrand",
  "history": [
    { "followers": 41651, "following": 210, "total_posts": 412, "reach": 6034, "profile_views": 341, "fetched_at": "2026-08-02T06:00:00Z" },
    { "followers": 41606, "following": 210, "total_posts": 411, "reach": 5120, "profile_views": 288, "fetched_at": "2026-08-01T06:00:00Z" }
  ]
}

Snapshot-Reihe

Ein Datenpunkt pro Erfassungslauf für Follower, Reichweite und Profilaufrufe.

Baue eigene Warnungen

Frage regelmäßig ab und benachrichtige, wenn ein Kanal seinen normalen Bereich verlässt.

Die Historie gehört dir

Speichere die Reihe in deinem Warehouse und behalte sie, so lange du willst.

Fragen zu Analyse-API, beantwortet

Woher kommen die Zahlen?

FoPost liest die Analysen jedes Netzwerks mit den Zugangsdaten des verbundenen Kontos aus und vereinheitlicht dann die Feldnamen. Die Werte entsprechen dem, was das Netzwerk in seinem eigenen Dashboard anzeigt.

Wie aktuell sind die Daten?

Metriken werden für jedes verbundene Konto regelmäßig aktualisiert. Ein heute veröffentlichter Beitrag zeigt innerhalb weniger Stunden erste Zahlen, die sich stabilisieren, sobald das Netzwerk seine Werte finalisiert.

Liefern alle Netzwerke dieselben Metriken?

Die Kernwerte Impressionen, Interaktionen und Follower sind überall gleich. Metriken, die ein Netzwerk nicht bereitstellt, werden als null statt als 0 zurückgegeben, so kannst du fehlende von leeren Werten unterscheiden.

Bekomme ich Metriken für Beiträge, die außerhalb der API veröffentlicht wurden?

Ja. Jeder über das verbundene Konto veröffentlichte Beitrag wird auf Kontoebene erfasst, und im Dashboard erstellte Beiträge haben IDs wie alle anderen.

Welchen Scope brauche ich?

Den analytics-Scope. Ein Schlüssel nur mit diesem Scope ist schreibgeschützt und kann weder veröffentlichen noch bearbeiten noch Konten verwalten.

Gibt es ein Rate Limit?

Ja, 100 Anfragen pro Minute und Schlüssel. Fasse Abfragen mit Datumsbereichen zusammen, statt einen Aufruf pro Tag zu machen.

Baue noch heute auf Analyse-API

Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.

API-Schlüssel holen