API de statistiquesAPI

Lisez les métriques de chaque réseau depuis un seul endpoint

FoPost collecte les données de performance de chaque compte connecté et les renvoie dans un format unique et cohérent. Récupérez une vue d'ensemble de l'espace de travail, examinez une publication ou suivez un compte dans le temps, puis injectez le tout dans vos outils de reporting.

Obtenir votre clé APILire la documentation
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 }]
}

Métriques normalisées

Impressions, engagement et abonnés utilisent les mêmes noms de champs sur tous les réseaux.

Trois niveaux

Vue d'ensemble de l'espace de travail, une publication ou un compte.

Autorisation en lecture seule

Une clé avec la seule autorisation analytics peut lire les chiffres, et rien d'autre.

Vue d'ensemble

Un seul appel pour le rapport mensuel

L'endpoint de vue d'ensemble additionne les données d'un espace de travail sur une période. Totaux des impressions, des engagements, de l'évolution des abonnés et des publications en ligne : une synthèse hebdomadaire ou un rapport client tient en une requête et un modèle.

Lire la référence des statistiques
Comptes connectés sur tous les réseaux dans un seul espace de travail

Périodes

Indiquez days pour une fenêtre glissante allant jusqu'à 365. Les écarts la comparent à la fenêtre précédente.

Filtrer par compte

Limitez la vue d'ensemble à un compte quand un client pose une question sur un canal.

Par espace de travail

Les clés d'agence sont propres à chaque espace de travail client : les rapports ne se mélangent jamais.

Par publication

Découvrez quelle publication a fait la différence

Chaque publication créée via l'API conserve son id, et cet id permet de lire les métriques de chaque réseau où elle a été diffusée. Croisez-les avec vos propres données de campagne, ou classez les publications du mois pour voir ce qui mérite d'être refait.

Voir les métriques par publication
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"
}

Détail par compte

Une publication, une ligne par réseau : vous voyez quel canal l'a portée.

Clics et permaliens

Les clics sur les liens et le permalien en ligne accompagnent les compteurs.

Regrouper par libellé

Listez d'abord les publications par libellé, puis lisez les métriques de l'ensemble.

Par compte

Suivez la croissance de chaque canal dans le temps

L'endpoint des comptes renvoie une série d'instantanés pour le nombre d'abonnés, la portée et les vues du profil. Alimentez vos propres graphiques, déclenchez une alerte en cas de baisse, ou montrez à un client la courbe qui monte à côté des publications qui l'ont fait bouger.

Commencer à développer
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" }
  ]
}

Série d'instantanés

Un point par collecte pour les abonnés, la portée et les vues du profil.

Créez vos propres alertes

Interrogez l'API à intervalles réguliers et soyez averti lorsqu'un canal sort de sa plage habituelle.

Gardez la main sur l'historique

Stockez la série dans votre entrepôt de données et conservez-la aussi longtemps que vous le souhaitez.

API de statistiques : vos questions, nos réponses

D'où viennent les chiffres ?

FoPost lit les statistiques propres à chaque réseau avec les identifiants du compte connecté, puis normalise les noms de champs. Les chiffres correspondent à ceux que le réseau affiche dans son propre tableau de bord.

Quelle est la fraîcheur des données ?

Les métriques sont actualisées à intervalles réguliers pour chaque compte connecté. Une publication du jour affiche ses premiers chiffres en quelques heures, qui se stabilisent à mesure que le réseau finalise ses comptages.

Tous les réseaux fournissent-ils les mêmes métriques ?

Le socle commun comprend les impressions, les engagements et les abonnés. Les métriques qu'un réseau n'expose pas sont renvoyées à null plutôt qu'à zéro, ce qui permet de distinguer une donnée absente d'une valeur vide.

Puis-je obtenir les métriques de publications créées en dehors de l'API ?

Oui. Toute publication effectuée via le compte connecté est suivie au niveau du compte, et les publications créées dans le tableau de bord ont des id comme les autres.

De quel scope ai-je besoin ?

Le scope analytics. Une clé limitée à ce scope est en lecture seule : elle ne peut ni publier, ni modifier, ni gérer des comptes.

Y a-t-il une limite de débit ?

Oui, 100 requêtes par minute et par clé. Regroupez vos lectures avec des plages de dates plutôt qu'un appel par jour.

Développez avec API de statistiques dès aujourd'hui

Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.

Obtenir votre clé API