Analyse-APIAPI

Lees de statistieken van elk netwerk uit één endpoint

FoPost verzamelt prestatiegegevens van elk gekoppeld account en levert ze terug in één consistent formaat. Vraag een werkruimteoverzicht op, duik in een post of volg een account in de tijd, en voer het door naar waarmee je ook rapporteert.

Haal je API-sleutel op Lees de documentatie

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

Genormaliseerde statistieken

Weergaven, engagement en volgers gebruiken op elk netwerk dezelfde veldnamen.

Drie niveaus

Werkruimteoverzicht, één post of één account.

Scope met alleen leesrechten

Een sleutel met alleen de scope analytics kan cijfers lezen en verder niets.

Overzicht

Eén aanroep voor het maandrapport

Het overview-endpoint telt een werkruimte op over een periode. Totalen voor weergaven, engagement, volgersverandering en gepubliceerde posts, dus een weekoverzicht of klantrapport is één request en een sjabloon.

Lees de analytics-referentie

Gekoppelde accounts op elk netwerk in één werkruimte

Periodes

Geef days op voor een terugkijkende periode van maximaal 365 dagen. Delta's vergelijken die met de periode ervoor.

Filter op account

Beperk het overzicht tot één account als een klant naar één kanaal vraagt.

Per werkruimte

Bureausleutels gelden per klantwerkruimte, dus rapporten raken nooit vermengd.

Per post

Ontdek welke post het werk deed

Elke post die je via de API maakt, houdt zijn id, en met dat id lees je de statistieken uit van elk netwerk waarop hij is verschenen. Combineer ze met je eigen campagnedata, of rangschik de posts van de maand en zie wat je moet herhalen.

Statistieken per post bekijken

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

Uitsplitsing per account

Eén post, één rij per netwerk, zodat je ziet welk kanaal hem droeg.

Klikken en permalinks

Linkklikken en de live permalink komen mee met de aantallen.

Groeperen op label

Toon eerst posts per label en lees dan de statistieken van die set.

Per account

Volg de groei van elk kanaal in de tijd

Het account-endpoint geeft een reeks snapshots van het aantal volgers, het bereik en de profielweergaven. Gebruik die in je eigen grafieken, stel een waarschuwing in bij een daling, of laat een klant de stijgende lijn zien naast de posts die hem in beweging brachten.

Begin met bouwen

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

Reeks snapshots

Eén punt per verzamelronde voor volgers, bereik en profielweergaven.

Bouw je eigen waarschuwingen

Vraag de data periodiek op en krijg een melding wanneer een kanaal buiten zijn normale bereik komt.

De geschiedenis is van jou

Sla de reeks op in je datawarehouse en bewaar hem zo lang als je wilt.

Vragen over Analyse-API, beantwoord

Waar komen de cijfers vandaan?

FoPost leest de eigen analyses van elk netwerk met de inloggegevens van het gekoppelde account en normaliseert daarna de veldnamen. De cijfers komen overeen met wat het netwerk in zijn eigen dashboard laat zien.

Hoe actueel zijn de gegevens?

Statistieken worden periodiek ververst voor elk gekoppeld account. Een post die vandaag is gepubliceerd, toont binnen enkele uren de eerste cijfers, die zich stabiliseren zodra het netwerk zijn tellingen afrondt.

Rapporteren alle netwerken dezelfde statistieken?

De basisset van weergaven, interacties en volgers is gedeeld. Statistieken die een netwerk niet aanbiedt, komen terug als null in plaats van nul, zodat je het verschil ziet tussen ontbrekend en leeg.

Kan ik statistieken krijgen voor posts die buiten de API zijn gepubliceerd?

Ja. Elke post die via het gekoppelde account is gepubliceerd, wordt op accountniveau gevolgd, en posts die in het dashboard zijn gemaakt, hebben net als alle andere een id.

Welke scope heb ik nodig?

De analytics-scope. Een sleutel met alleen die scope is alleen-lezen en kan niet publiceren, bewerken of accounts beheren.

Is er een rate limit?

Ja, 100 verzoeken per minuut per sleutel. Lees in batches met datumbereiken in plaats van één aanroep per dag.

Bouw vandaag nog op de Analyse-API

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Haal je API-sleutel op