Données ouvertes et outils

API Pageviews de Wikimedia : des données de demande libres et gratuites pour planifier ses contenus

Mis à jour le Publié le Par la rédaction7 min4 sources

L'essentiel

  • L'API Wikimedia Analytics fournit les nombres de pages vues quotidiens et mensuels de tout article de Wikipédia depuis le 1er juillet 2015, sans clé d'API.
  • Chaque requête doit porter un en-tête User-Agent descriptif avec des coordonnées de contact ; les requêtes sans en-tête peuvent être bloquées sans préavis.
  • Les données de l'API Analytics sont disponibles sous licence CC0 1.0 : les chiffres peuvent donc être republiés.
  • Utilisez agent=user pour exclure les robots qui s'identifient comme tels, et rappelez-vous que les redirections ne comptent pas comme des vues de la page cible.
  • Les pages vues mesurent l'intérêt pour la lecture d'un sujet sur Wikipédia ; c'est un signal de demande relatif, pas une prévision de trafic de recherche ni de revenus publicitaires.
Rangées de serveurs de la Wikimedia Foundation dans un centre de données
Image: Wikimedia Foundation Servers-8055 13,Victorgrigas,CC BY-SA 3.0,via Wikimedia Commons.

L’API Wikimedia Pageviews fournit gratuitement et publiquement les nombres de vues quotidiens et mensuels de chaque article de Wikipédia depuis juillet 2015, sans clé ni compte. Pour un éditeur qui planifie ses contenus, c’est un signal de demande transparent : comparer des sujets, repérer la saisonnalité et vérifier si l’intérêt progresse. Elle mesure la lecture sur Wikipédia ; considérez-la donc comme un indicateur relatif, pas comme un volume de recherche.

Pourquoi utiliser les pages vues de Wikipédia pour étudier un sujet ?

Les outils de mots-clés estiment le volume de recherche avec des modèles non divulgués. Les pages vues sont comptées, publiées ouvertement et reproductibles par tous. Elles répondent bien à trois questions :

  • L’intérêt pour le sujet A est-il plus grand ou plus petit que pour le sujet B ? Deux articles de Wikipédia de portée comparable donnent une comparaison honnête.
  • Quand l’intérêt culmine-t-il ? Les données quotidiennes montrent les pics liés aux fêtes, aux périodes d’examens ou à l’actualité, ce qui aide à planifier les mises à jour (voir saisonnalité d’AdSense pour le côté revenus).
  • Un sujet s’essouffle-t-il ? Cinq ans ou plus de données mensuelles montrent la direction à long terme.

Elles sont moins utiles pour l’intention commerciale. Celui qui lit l’article de Wikipédia sur une maladie n’est pas le même visiteur que celui qui compare des produits.

La règle du User-Agent à respecter

La politique d’accès de l’API Analytics exige un User-Agent HTTP sur chaque requête ; les requêtes qui n’en ont pas peuvent être bloquées sans préavis. L’en-tête doit identifier votre application et inclure des coordonnées : l’URL d’un site, une adresse e-mail ou une page utilisateur de wiki. Le JavaScript exécuté dans un navigateur peut envoyer Api-User-Agent à la place, car les navigateurs ne permettent pas aux scripts de définir User-Agent.

La politique User-Agent de Wikimedia ajoute : n’utilisez pas d’agents génériques tels que curl ou Python-urllib seuls, incluez « bot » si votre client en est un, et ne copiez jamais le User-Agent d’un navigateur, car un comportement de robot avec un User-Agent de navigateur est présumé malveillant. Son format d’exemple est CoolBot/0.0 (https://example.org/coolbot/; coolbot@example.org) generic-library/0.0.

Pour un script de recherche ponctuel, quelque chose comme ceci suffit :

UA="MySiteTopicResearch/1.0 (https://www.example.com/contact; you@example.com)"

La politique d’accès demande aussi d’attendre la fin de chaque requête avant d’envoyer la suivante. Les limites de débit dépendent de votre identité et de votre niveau d’accès ; aucun chiffre fixe n’est publié pour les clients anonymes.

Comment obtenir les pages vues d’un article ?

Le point d’accès par article prend le projet, le mode d’accès, le type d’agent, le titre de l’article, la granularité et une plage de dates :

https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/
  {project}/{access}/{agent}/{article}/{granularity}/{start}/{end}
Paramètre Valeurs
project en.wikipedia, fr.wikipedia, de.wikipedia, etc.
access all-access, desktop, mobile-web, mobile-app
agent all-agents, user, spider, automated
article titre avec tirets bas, encodé pour une URL (Google_AdSense)
granularity daily ou monthly
start / end YYYYMMDD (ou YYYYMMDDHH)
curl -s -A "$UA" \
  "https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/en.wikipedia/all-access/user/Google_AdSense/monthly/20251101/20261031"

Sortie réelle (appel effectué le 2026-11-18)

Voici la réponse réelle de cette requête, réduite au mois et aux vues, obtenue le 18 novembre 2026 :

Mois Vues de « Google_AdSense » sur en.wikipedia (agent=user)
2025-11 10 542
2025-12 11 508
2026-01 12 384
2026-02 11 787
2026-03 12 461
2026-04 11 160
2026-05 9 173
2026-06 8 225
2026-07 7 961
2026-08 8 810
2026-09 10 663
2026-10 9 754

Le même jour, la ventilation d’octobre 2026 par mode d’accès a donné 7 042 vues sur mobile-web et 2 645 sur desktop. Même pour un sujet professionnel, la plupart des lecteurs de Wikipédia venaient de téléphones ce mois-là.

La comparaison d’articles voisins sur les mêmes 12 mois fait ressortir rapidement les écarts d’échelle. Dans la même extraction, Real-time_bidding allait de 715 à 1 363 vues par mois, Ads.txt de 439 à 802 et Header_bidding de 143 à 365. Chaque élément JSON contient project, article, granularity, timestamp, access, agent et views.

Autres points d’accès utiles

La référence des pages vues énumère des points d’accès pour le total des vues d’un projet, les vues par pays, les pages les plus vues et les pages les plus vues par pays.

Total mensuel des vues humaines de Wikipédia en anglais (utile comme dénominateur) :

curl -s -A "$UA" \
  "https://wikimedia.org/api/rest_v1/metrics/pageviews/aggregate/en.wikipedia/all-access/user/monthly/2026090100/2026103100"

Le 2026-11-18, cet appel a renvoyé 6 271 394 362 vues pour septembre 2026 et 6 104 126 269 pour octobre 2026. Diviser les vues d’un article par le total du projet supprime l’effet des variations du trafic global de Wikipédia.

Exemple détaillé : vues par million

Avec les deux appels ci-dessus, on peut exprimer l’audience d’un article comme une part de toutes les vues humaines de Wikipédia en anglais, ce qui rend les mois comparables :

Mois Google_AdSense (user) Total en.wikipedia (user) Vues par million
Septembre 2026 10 663 6 271 394 362 1,70
Octobre 2026 9 754 6 104 126 269 1,60

Les vues brutes ont reculé d’environ 8,5 % entre les deux mois, alors que la part a reculé d’environ 6 %, parce que Wikipédia dans son ensemble a aussi eu un mois d’octobre plus faible. L’écart est faible ici, mais pendant les périodes de vacances ou après de gros événements d’actualité, le total du projet peut beaucoup varier, et la part raconte alors une histoire plus honnête que le nombre brut. Utilisez le même filtre d’agent (user) dans les deux appels, sans quoi le rapport n’a aucun sens.

Articles les plus consultés d’un mois :

curl -s -A "$UA" \
  "https://wikimedia.org/api/rest_v1/metrics/pageviews/top/en.wikipedia/all-access/2026/10/all-days"

Maniez les listes « top » avec prudence. Dans la liste d’octobre 2026 récupérée le même jour, Main_Page, Special:Search et Wikipedia:Featured_pictures figuraient parmi les premières entrées, et certains comptages d’articles dépassaient de très loin ce que leur couverture médiatique pouvait expliquer. Les listes « top » sont l’endroit où un trafic inhabituel apparaît en premier.

Un script de comparaison simple

Ce script Node.js (Node 18 ou plus récent, qui dispose de fetch) affiche 12 mois de vues pour plusieurs titres, une requête à la fois :

// compare-topics.mjs
const UA = 'MySiteTopicResearch/1.0 (https://www.example.com/contact)';
const titles = ['Sourdough', 'Air_fryer', 'Pressure_cooking'];
const base = 'https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article';

for (const t of titles) {
  const url = `${base}/en.wikipedia/all-access/user/${encodeURIComponent(t)}/monthly/20251101/20261031`;
  const res = await fetch(url, { headers: { 'User-Agent': UA } });
  if (!res.ok) { console.log(t, res.status); continue; }
  const { items } = await res.json();
  const total = items.reduce((sum, i) => sum + i.views, 0);
  console.log(t, total, items.map((i) => i.views).join(','));
}

Exécuté le 2026-11-18, il a affiché des totaux sur 12 mois de 418 702 vues pour Sourdough, 32 017 pour Air_fryer et 8 526 pour Pressure_cooking (agent=user). Remplacez-les par les articles les plus proches de vos propres sujets.

Comment interpréter les chiffres ?

Les définitions des pages vues fixent les limites :

  • Une page vue est une requête de contenu de page ayant reçu la réponse « 200 OK » ou « 304 Not Modified ». Les modifications et la plupart des pages spéciales ne comptent pas.
  • Les redirections ne comptent pas pour la page cible. Les vues arrivées par un autre titre sont perdues, sauf si vous interrogez aussi ce titre.
  • spider couvre les agents qui s’identifient comme des robots ; automated désigne un autre trafic automatisé repéré par des heuristiques. La détection est approximative : même agent=user peut contenir du bruit.

Règles pratiques :

  1. Comparer ce qui est comparable. Même édition linguistique, même plage de dates, même filtre d’agent.
  2. Utiliser des médianes pour les sujets en dents de scie. Une seule journée d’actualité peut tripler un total mensuel.
  3. Vérifier l’édition linguistique qui correspond à votre audience. Dans le même appel, l’article français « Google_AdSense » a eu 374 vues en novembre 2025, une fraction de l’article anglais.
  4. Ne pas convertir les pages vues en revenus. Rien ne relie la lecture de Wikipédia à votre RPM. Servez-vous-en pour classer des sujets, puis validez avec vos propres données de Search Console.

Erreurs fréquentes

  • Envoyer des requêtes avec le User-Agent par défaut d’une bibliothèque et se faire bloquer.
  • Se tromper de majuscules. Le 2026-11-18, google_adsense a renvoyé une erreur 404 « Not Found » alors que Google_AdSense renvoyait des données. (Un espace encodé, Google%20AdSense, menait au même article.)
  • Lire les chiffres all-agents comme de l’intérêt humain. Pour Google_AdSense en octobre 2026, l’API indiquait 9 754 vues user, 2 563 automated et 1 314 spider : plus d’un tiers en plus du compte humain.
  • Prendre la demande pour une autorisation de publier des pages creuses sur chaque sujet populaire. Les données de demande aident à choisir des sujets ; elles ne remplacent pas la substance que recherchent les relecteurs (voir quelle quantité de contenu prévoir).

Pour ajouter un contexte par pays à la demande par sujet, associez cette approche aux données ouvertes sur les internautes par pays.

Questions fréquentes

Faut-il une clé d'API pour l'API Wikimedia Pageviews ?

Non. La politique d'accès de l'API Analytics n'exige ni clé, ni jeton, ni connexion. La seule identification demandée est un en-tête HTTP User-Agent qui nomme votre application et donne des coordonnées, comme l'URL d'un site ou une adresse e-mail. Les scripts exécutés dans un navigateur peuvent envoyer un en-tête Api-User-Agent à la place. Envoyez les requêtes l'une après l'autre plutôt qu'en grosses rafales parallèles.

Jusqu'où remontent les données de pages vues de Wikipédia ?

Les points d'accès actuels servent des données à partir du 1er juillet 2015. Les chiffres plus anciens n'existent que via un point d'accès hérité distinct, avec une méthodologie différente : ne joignez donc pas les deux séries dans un même graphique sans le signaler. Pour planifier des contenus, les deux ou trois dernières années suffisent généralement à voir la saisonnalité et la direction à long terme.

Puis-je republier sur mon site les chiffres de l'API Pageviews ?

Oui. La politique d'accès de l'API Analytics indique que ses données sont disponibles sous licence CC0 1.0, qui les place dans le domaine public. Citer Wikimedia comme source et indiquer la date de votre requête reste une bonne pratique, car les comptages peuvent être révisés et les lecteurs doivent pouvoir reproduire vos chiffres.

Pourquoi un article populaire affiche-t-il peu de pages vues ?

Vérifiez le titre exact. Les pages vues sont comptées par titre, et les vues d'une redirection (par exemple une autre orthographe) ne comptent pas comme des vues de l'article cible. Utilisez le titre canonique (tirets bas à la place des espaces), vérifiez les majuscules et interrogez la bonne édition linguistique, car en.wikipedia et fr.wikipedia sont des projets distincts.

Sources

  1. Page view analytics | Wikimedia Analytics API · Wikimedia Foundation
  2. Page views | Wikimedia Analytics API · Wikimedia Foundation
  3. Access policy | Wikimedia Analytics API · Wikimedia Foundation
  4. Policy:Wikimedia Foundation User-Agent Policy · Wikimedia Foundation