API Matomo : toutes les méthodes de l’API de reporting

Matomo expose la totalité de ses données via une API HTTP : tout ce que vous lisez dans l'interface peut être récupéré en JSON, XML, CSV ou directement en image. Cette page recense l'ensemble des méthodes disponibles, module par module, avec leurs paramètres — ce que la documentation officielle disperse sur plusieurs dizaines de pages.

Comment appeler l'API Matomo

Tous les appels passent par un point d'entrée unique, index.php, avec module=API et le nom de la méthode voulue :

https://votre-matomo.example/index.php?module=API
    &method=VisitsSummary.get
    &idSite=1
    &period=day
    &date=yesterday
    &format=JSON
    &token_auth=VOTRE_JETON

Les paramètres qui reviennent partout :

• method — le module et la méthode, par exemple Actions.getPageUrls.
• idSite — l'identifiant du site mesuré. Plusieurs sites : idSite=1,2,3, ou all pour tous.
• period — day, week, month, year ou range.
• date — today, yesterday, une date AAAA-MM-JJ, ou une plage 2026-01-01,2026-01-31 avec period=range.
• format — JSON, XML, CSV, TSV ou HTML.
• segment — un segment appliqué à la volée, par exemple segment=countryCode==fr;deviceType==smartphone.
• token_auth — le jeton d'authentification, à créer depuis Administration > Personnel > Sécurité. À transmettre en POST plutôt qu'en paramètre d'URL dès que possible : une URL se retrouve dans les journaux serveur.

Dans les signatures ci-dessous, un paramètre affiché en noir est obligatoire ; un paramètre en gris, accompagné de sa valeur par défaut, est facultatif.

Les 58 modules

• AbTesting 18
• Actions 18
• ActivityLog 2
• AdvertisingConversionExport 6
• Annotations 7
• API 18
• ConnectAccounts 3
• Contents 2
• CoreAdminHome 3
• CrashAnalytics 32
• CustomAlerts 7
• CustomDimensions 7
• CustomJsTracker 1
• CustomReports 10
• CustomVariables 3
• Dashboard 5
• DevicePlugins 1
• DevicesDetection 8
• Events 9
• Feedback 3
• FormAnalytics 24
• Funnels 11
• Goals 11
• HeatmapSessionRecording 31
• ImageGraph 1
• Insights 5
• LanguagesManager 9
• Live 4
• Login 1
• MarketingCampaignsReporting 11
• MediaAnalytics 15
• MobileMessaging 10
• MultiChannelConversionAttribution 5
• MultiSites 3
• Overlay 3
• PagePerformance 1
• PrivacyManager 6
• Referrers 19
• Resolution 2
• RollUpReporting 3
• ScheduledReports 6
• SearchEngineKeywordsPerformance 12
• SegmentEditor 6
• SEO 1
• SitesManager 50
• TagManager 45
• Tour 3
• Transitions 5
• TwoFactorAuth 1
• UserCountry 8
• UserId 1
• UserLanguage 2
• UsersFlow 4
• UsersManager 31
• VisitFrequency 1
• VisitorInterest 4
• VisitsSummary 10
• VisitTime 3