Interroger les statistiques
Lisez les chiffres d’activité de toute la plateforme, d’un espace ou d’une story : utilisateurs actifs, activité dans le temps, utilisateurs les plus actifs.
L’API fournit des chiffres d’activité à trois niveaux. Pour des informations sur le contenu lui-même, utilisez plutôt une requête de recherche.
| Niveau | Point d’entrée |
|---|---|
| Toute la plateforme | instance { statistics { ... } } |
| Un espace | space(slug:) { analytics { ... } } |
| Une story | story(slug:) { analytics { ... } } |
La plupart des champs prennent une période (fromDate et toDate). Ceux qui renvoient une série prennent aussi un tickInterval : DAY, WEEK ou MONTH.
Statistiques de la plateforme
Cet exemple compte les utilisateurs actifs sur quatre mois, lit leur activité semaine par semaine et liste les 10 plus actifs :
query platformStatistics {
instance {
statistics {
activeUsersCount(fromDate: "2026-01-01T00:00:00", toDate: "2026-05-01T00:00:00")
usersActivity(fromDate: "2026-01-01T00:00:00", toDate: "2026-05-01T00:00:00", tickInterval: WEEK)
mostActiveUsers(fromDate: "2026-01-01T00:00:00", toDate: "2026-05-01T00:00:00", first: 10) {
edges {
node {
user {
name
}
stats
}
}
}
}
}
}
La réponse :
{
"data": {
"instance": {
"statistics": {
"activeUsersCount": 28,
"usersActivity": [
["2026-01-01T01:00:00Z", 13],
["2026-01-08T01:00:00Z", 13]
],
"mostActiveUsers": {
"edges": [
{
"node": {
"user": { "name": "Knowledge Master" },
"stats": { "likes": 0, "comments": 0, "views": 3221, "publications": 0, "updates": 12, "reshares": 0, "annotations": 0, "all_events": 3695 }
}
},
{
"node": {
"user": { "name": "Jane Doe" },
"stats": { "likes": 0, "comments": 7, "views": 697, "publications": 62, "updates": 40, "reshares": 3, "annotations": 0, "all_events": 1085 }
}
}
]
}
}
}
}
}
Une série comme usersActivity est une liste de paires : le début d’un intervalle et sa valeur.
Chiffres d’un espace et d’une story
Le champ analytics d’un espace expose des champs du même type, dont activeUsersCount, viewsTrends, publicationsTrends et mostActiveContentTable. Celui d’une story expose viewsTrends, uniqueViewsTrends, commentsTrends et likesTrends, qui nécessitent tous story.actions.advancedStats :
query storyViews {
story(slug: 123) {
analytics {
viewsTrends(fromDate: "2026-01-01T00:00:00", toDate: "2026-05-01T00:00:00", tickInterval: MONTH)
}
}
}
La référence GraphQL liste tous les champs de InstanceStatistics, SpaceAnalytics et StoryAnalytics.