API di analisiAPI

Leggi le metriche di ogni rete da un solo endpoint

FoPost raccoglie i dati sulle prestazioni di ogni account collegato e li restituisce in un formato coerente. Ottieni una panoramica del workspace, approfondisci un post o segui un account nel tempo, e invia tutto allo strumento che usi per i report.

Ottieni la tua chiave APILeggi la documentazione
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 }]
}

Metriche normalizzate

Impression, engagement e follower usano gli stessi nomi di campo su ogni rete.

Tre livelli

Panoramica del workspace, un post o un account.

Scope di sola lettura

Una chiave con il solo scope analytics può leggere i numeri e nient'altro.

Panoramica

Una sola chiamata per il report mensile

L'endpoint di panoramica somma i dati di un workspace in un intervallo di date. Totali di impression, interazioni, variazione dei follower e post pubblicati, così un riepilogo settimanale o un report per un cliente richiedono una sola richiesta e un modello.

Leggi la documentazione delle analisi
Account collegati su tutte le reti in un unico workspace

Intervalli di date

Passa days per una finestra mobile fino a 365 giorni. Le variazioni la confrontano con la finestra precedente.

Filtra per account

Restringi la panoramica a un account quando un cliente chiede di un canale.

Per workspace

Le chiavi delle agenzie sono per workspace cliente, quindi i report non si mescolano mai.

Per post

Scopri quale post ha fatto la differenza

Ogni post che crei tramite l'API conserva il suo id, e quell'id restituisce le metriche di ogni rete su cui è stato pubblicato. Uniscile ai dati delle tue campagne, oppure metti in classifica i post del mese e scopri cosa ripetere.

Vedi le metriche per post
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"
}

Dettaglio per account

Un post, una riga per rete, così vedi quale canale l'ha portato avanti.

Clic e permalink

I clic sui link e il permalink attivo arrivano insieme ai conteggi.

Raggruppa per etichetta

Elenca prima i post per etichetta, poi leggi le metriche del gruppo.

Per account

Monitora la crescita di ogni canale nel tempo

L'endpoint account restituisce una serie di snapshot per numero di follower, copertura e visualizzazioni del profilo. Usala nei tuoi grafici, imposta un avviso in caso di calo o mostra a un cliente la linea che sale accanto ai post che l'hanno fatta muovere.

Inizia a sviluppare
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" }
  ]
}

Serie di snapshot

Un punto per ogni raccolta di follower, copertura e visualizzazioni del profilo.

Crea i tuoi avvisi

Interroga l'API a intervalli regolari e ricevi una notifica quando un canale esce dal suo intervallo normale.

Lo storico è tuo

Salva la serie nel tuo data warehouse e conservala per tutto il tempo che vuoi.

API di analisi: le risposte alle tue domande

Da dove vengono i numeri?

FoPost legge le analisi di ogni rete con le credenziali dell'account collegato, poi normalizza i nomi dei campi. I dati coincidono con quelli che la rete mostra nella propria dashboard.

Quanto sono aggiornati i dati?

Le metriche si aggiornano periodicamente per ogni account collegato. Un post pubblicato oggi mostra i primi numeri entro poche ore e si stabilizza quando la rete finalizza i conteggi.

Tutte le reti riportano le stesse metriche?

Il set di base di impression, interazioni e follower è comune. Le metriche che una rete non espone vengono restituite come null e non come zero, così distingui un dato assente da uno vuoto.

Posso ottenere le metriche dei post pubblicati fuori dall'API?

Sì. Ogni post pubblicato tramite l'account collegato viene monitorato a livello di account, e i post creati nella dashboard hanno un id come tutti gli altri.

Quale scope mi serve?

Lo scope analytics. Una chiave con solo quello scope è di sola lettura e non può pubblicare, modificare o gestire account.

Esiste un limite di richieste?

Sì, 100 richieste al minuto per chiave. Raggruppa le letture con intervalli di date invece di fare una chiamata al giorno.

Sviluppa oggi con API di analisi

Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.

Ottieni la tua chiave API