APIAnalytics
Google Analytics 4 API. Kanalen, pagina's, doelgroep en conversies voor je eigen dashboard.
Je koppelt de Google Analytics 4-property van elke site in MarketingTracer, en wij houden die koppeling actief. Met één API-key haal je sitetotalen, dagelijkse trends, kanalen, pagina's, doelgroep, conversies en referrers voor elke klantsite op in je eigen dashboard, rapport of AI-assistent. De REST API en de MCP-server zitten zonder meerprijs in elk pakket.
Totalen en dagcijfers
Sitetotalen met periodevergelijking, plus dagelijkse sessies, sessies met betrokkenheid, gebruikers en conversies.
Uitsplitsingen per rapport
Kanalen, bronnen, landingspagina's, bekeken pagina's, doelgroep, events, e-commerceproducten en externe referrers.
Gedeelde filters
Geef kanaal, bron, landingspagina, map, land en apparaat mee aan alle rapporten om stap voor stap in te zoomen.
In elk pakket
Één persoonlijke API-key voor REST en MCP, met 60 calls per minuut over al je sites.
Google Analytics 4-endpoints in REST en de MCP-server
Stuur een POST met een JSON-body of een GET met queryparameters naar /rest/v1/. Je persoonlijke API-key zet je in de header als Bearer-token. Geef de site_id mee uit list_sites of kopieer die uit het adres van de site in de app.
Elk endpoint accepteert een datumbereik via from en to of via days (standaard 28). Het bereik loopt tot en met gisteren, omdat de Google Analytics 4-cijfers van vandaag nog niet compleet zijn. Zet compare op previous_period of previous_year (52 weken terug, zodat weekdagen overeenkomen). Filter op elke combinatie van channel, source_medium, landing_page, path_prefix, country en device.
| Endpoint | MCP-tool | Wat het teruggeeft |
|---|---|---|
analytics.summary | get_analytics_summary | Sitetotalen voor sessies, sessies met betrokkenheid, betrokkenheidspercentage, gebruikers, nieuwe gebruikers, weergaven, weergaven per sessie, gemiddelde sessieduur, conversies en omzet met periodevergelijking, plus een dagreeks voor beide periodes. |
analytics.channels | get_analytics_channels | Sessies, betrokkenheid, gebruikers, weergaven, conversies en omzet per GA4-kanaalgroep (Organic Search, Direct, Referral, AI Assistant en meer), aandeel in de sessies en cijfers uit de vorige periode. |
analytics.sources | get_analytics_sources | De overzichtscijfers per bron en medium (zoals google / organic of chatgpt.com / referral), aandeel in de sessies en cijfers uit de vorige periode. |
analytics.landing_pages | get_analytics_landing_pages | De overzichtscijfers per instappaginapad en volledige URL, aandeel in de sessies en cijfers uit de vorige periode. |
analytics.pages | get_analytics_pages | Paginaweergaven, sessies, gebruikers, betrokkenheidspercentage en gemiddelde sessieduur per bekeken paginapad en URL, plus aandeel in de weergaven en cijfers uit de vorige periode. |
analytics.audience | get_analytics_audience | De overzichtscijfers per land, plaats, apparaat, browser, taal of new_vs_returning, met aandeel in de sessies en cijfers uit de vorige periode. |
analytics.events | get_analytics_events | Aantal events, key-event-conversies, gebruikers en omzet per GA4-eventnaam, naast de vorige periode. |
analytics.products | get_analytics_products | E-commerce-productomzet, gekochte items en bekeken items per productnaam, naast de vorige periode. |
analytics.referrers | get_analytics_referrers | Externe verwijzende URL's en domeinen gekoppeld aan de landingspagina op je site, sessies, sessies met betrokkenheid, weergaven, cijfers uit de vorige periode en een domain_only-vlag. |
In Claude Code of Cursor geven de get_analytics_*-tools dezelfde rapporten terug. De MCP-server bevat daarnaast de vrije get_analytics-tool (alleen MCP). Gebruik die om elke gewenste GA4-dimensie en -metric op te vragen, paden te filteren met een reguliere expressie via path_regex, of pagina's samen te vatten per URL-map met group_by_section.
Wat een call naar analytics.summary teruggeeft
Geef site_id en optionele periode- of filterargumenten mee. Standaard staat days op 28 en compare op previous_period.
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.summary \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","days":28}'
{
"data": {
"compare": "previous_period",
"sessions": {"value": 1150, "previous": 1031, "change": 119, "change_pct": 11.5},
"engaged_sessions": {"value": 752, "previous": 703, "change": 49, "change_pct": 7},
"engagement_rate_pct": {"value": 65.4, "previous": 68.2, "change": -2.8, "change_pct": -4.1},
"users": {"value": 727, "previous": 674, "change": 53, "change_pct": 7.9},
"new_users": {"value": 669, "previous": 622, "change": 47, "change_pct": 7.6},
"views": {"value": 2668, "previous": 2379, "change": 289, "change_pct": 12.1},
"views_per_session": {"value": 2.32, "previous": 2.31, "change": 0.01, "change_pct": 0.4},
"avg_session_duration_seconds": {"value": 166.2, "previous": 178.4, "change": -12.2, "change_pct": -6.8},
"conversions": {"value": 291, "previous": 205, "change": 86, "change_pct": 42},
"revenue_eur": {"value": 0, "previous": 0, "change": 0, "change_pct": null},
"daily": [
{
"date": "2026-10-06",
"sessions": 37,
"engaged_sessions": 26,
"users": 33,
"conversions": 6,
"previous_date": "2026-09-08",
"previous_sessions": 40,
"previous_engaged_sessions": 27,
"previous_users": 34,
"previous_conversions": 7
},
{
"date": "2026-10-07",
"sessions": 52,
"engaged_sessions": 32,
"users": 37,
"conversions": 14,
"previous_date": "2026-09-09",
"previous_sessions": 37,
"previous_engaged_sessions": 29,
"previous_users": 33,
"previous_conversions": 12
},
…
]
},
"meta": {
"site_id": "YOUR_SITE_ID",
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Elk totaal bevat value, previous, change en change_pct (voor engagement_rate_pct is change in procentpunten). Elk item in daily koppelt een datum uit het huidige venster aan previous_date uit het vergelijkingsvenster, zodat je een grafiek met twee lijnen direct vanuit de array tekent. Is sessions gelijk aan 0, dan komen engagement_rate_pct, views_per_session en avg_session_duration_seconds terug als null. Een previous-waarde van 0 geeft ook change_pct: null, zoals bij revenue_eur hierboven. Is Google Analytics 4 niet gekoppeld voor de site, dan geeft de call HTTP 409 terug met foutcode not_connected.
Zoom met dezelfde filters in van kanalen naar bronnen en landingspagina's
Een maandagrapport laat zien dat conversies in Organic Search zijn gestegen, terwijl de mobiele betrokkenheid daalde. Geef channel: "Organic Search" mee aan analytics.sources om google / organic te scheiden van andere zoekmachines. Roep daarna analytics.landing_pages aan met source_medium: "google / organic", path_prefix: "/rental/" en device: "mobile".
De sessiefilters (channel, source_medium, landing_page, path_prefix, country en device) werken samen over analytics.summary en alle sessie-uitsplitsingen. Elke rij bevat een previous-object (voor de voorgaande periode of previous_year bij seizoensgevoelige shops), zodat je dashboard de vergelijking vanuit één request rendert.
Zie welke externe pagina's en AI-assistenten bezoekers sturen, en waar ze landen
Wordt een klant genoemd op een forum, een partnerblog of in een AI-assistent, dan koppelt analytics.referrers elke referrer_url en elk referrer_domain aan de landing_page op de site van de klant, inclusief sessions, engaged_sessions en views voor beide periodes. Zoekmachines en zelfverwijzingen zijn al weggefilterd.
Combineer dit met source_medium: "chatgpt.com / referral" om één bron te onderzoeken. Veel browsers korten de referrer-header in tot de origin. Gebeurt dat, dan bevat referrer_url alleen https://domain en staat domain_only op true. Zo maakt je rapport onderscheid tussen een referrer op domeinniveau en een volledige artikel-URL.
Zet doelgroep, key events en e-commerce-productomzet op één klantoverzicht
Roep analytics.audience aan met by ingesteld op country, city, device, browser, language of new_vs_returning. Elke uitsplitsing laat zien wie de site bezoekt en hoe de betrokkenheid zich verhoudt tot de vorige periode.
Naast de doelgroep toont analytics.events elke GA4-eventnaam met het totaal voor count, conversions, users en revenue_eur. Voor webshops die itemdata naar GA4 sturen, voegt analytics.products daar revenue_eur, purchased en viewed per product aan toe.
Endpoints, argumenten en veldbeschrijvingen
Elk endpoint is een POST met een JSON-body; lees-endpoints accepteren ook een GET met dezelfde argumenten in de querystring. Stuur je API-key mee als Authorization: Bearer YOUR_API_KEY. Elk antwoord heeft de vorm {"data": …, "meta": {…}}: altijd meta.site_id, bij een lijst meta.next_cursor en meta.total, en meta.period als het endpoint over een periode gaat. Een foutmelding is {"error": {"code", "message"}} met de HTTP-status: 400 invalid_argument, unknown_argument of missing_argument; 401 not_authenticated; 403 no_access of tool_off; 404 not_found; 409 not_connected (een koppeling die het endpoint nodig heeft, zoals Google Analytics 4, ontbreekt); 429 rate_limited; 502 google_error (Google gaf een fout terug). De machineleesbare versie staat op openapi.json.
analytics.summary
POST /rest/v1/analytics.summary · MCP-tool get_analytics_summary
Geeft de Google Analytics 4-totalen van één site voor de periode afgezet tegen de vorige periode: sessies, sessies met betrokkenheid, betrokkenheidspercentage, gebruikers, nieuwe gebruikers, paginaweergaven, weergaven per sessie, gemiddelde sessieduur, conversies (key events) en omzet, elk als value, previous, change en verandering in procenten; plus per dag de sessies, sessies met betrokkenheid, gebruikers en conversies van beide periodes. De periode loopt tot uiterlijk gisteren. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.summary \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","days":28}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd; daily is ingekort tot twee dagen (een periode van 28 dagen heeft er 28).
{
"data": {
"compare": "previous_period",
"sessions": {"value": 1150, "previous": 1031, "change": 119, "change_pct": 11.5},
"engaged_sessions": {"value": 752, "previous": 703, "change": 49, "change_pct": 7},
"engagement_rate_pct": {"value": 65.4, "previous": 68.2, "change": -2.8, "change_pct": -4.1},
"users": {"value": 727, "previous": 674, "change": 53, "change_pct": 7.9},
"new_users": {"value": 669, "previous": 622, "change": 47, "change_pct": 7.6},
"views": {"value": 2668, "previous": 2379, "change": 289, "change_pct": 12.1},
"views_per_session": {"value": 2.32, "previous": 2.31, "change": 0.01, "change_pct": 0.4},
"avg_session_duration_seconds": {"value": 166.2, "previous": 178.4, "change": -12.2, "change_pct": -6.8},
"conversions": {"value": 291, "previous": 205, "change": 86, "change_pct": 42},
"revenue_eur": {"value": 0, "previous": 0, "change": 0, "change_pct": null},
"daily": [
{
"date": "2026-10-06",
"sessions": 37,
"engaged_sessions": 26,
"users": 33,
"conversions": 6,
"previous_date": "2026-09-08",
"previous_sessions": 40,
"previous_engaged_sessions": 27,
"previous_users": 34,
"previous_conversions": 7
},
{
"date": "2026-10-07",
"sessions": 52,
"engaged_sessions": 32,
"users": 37,
"conversions": 14,
"previous_date": "2026-09-09",
"previous_sessions": 37,
"previous_engaged_sessions": 29,
"previous_users": 33,
"previous_conversions": 12
}
]
},
"meta": {
"site_id": "YOUR_SITE_ID",
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · in data:
| Veld | Type | Wat het is |
|---|---|---|
compare | string | previous_period of previous_year: waar de vorige cijfers op slaan. |
sessions | object | Sessies in de periode, afgezet tegen de vorige periode. |
sessions.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
sessions.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
sessions.change | number of null | value min previous. |
sessions.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
engaged_sessions | object | Sessies met betrokkenheid in de periode, afgezet tegen de vorige periode. |
engaged_sessions.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
engaged_sessions.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
engaged_sessions.change | number of null | value min previous. |
engaged_sessions.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
engagement_rate_pct | object | Betrokkenheidspercentage, 0-100, in de periode, afgezet tegen de vorige periode. |
engagement_rate_pct.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
engagement_rate_pct.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
engagement_rate_pct.change | number of null | value min previous, in procentpunten. |
engagement_rate_pct.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
users | object | Gebruikers in de periode, afgezet tegen de vorige periode. |
users.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
users.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
users.change | number of null | value min previous. |
users.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
new_users | object | Nieuwe gebruikers in de periode, afgezet tegen de vorige periode. |
new_users.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
new_users.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
new_users.change | number of null | value min previous. |
new_users.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
views | object | Paginaweergaven in de periode, afgezet tegen de vorige periode. |
views.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
views.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
views.change | number of null | value min previous. |
views.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
views_per_session | object | Paginaweergaven per sessie in de periode, afgezet tegen de vorige periode. |
views_per_session.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
views_per_session.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
views_per_session.change | number of null | value min previous. |
views_per_session.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
avg_session_duration_seconds | object | Gemiddelde sessieduur in seconden in de periode, afgezet tegen de vorige periode. |
avg_session_duration_seconds.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
avg_session_duration_seconds.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
avg_session_duration_seconds.change | number of null | value min previous. |
avg_session_duration_seconds.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
conversions | object | Conversies (key events) in de periode, afgezet tegen de vorige periode. |
conversions.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
conversions.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
conversions.change | number of null | value min previous. |
conversions.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
revenue_eur | object | Omzet in de periode, afgezet tegen de vorige periode. |
revenue_eur.value | number of null | Deze periode; null als dit niet van toepassing is (geen sessies). |
revenue_eur.previous | number of null | De vorige periode; null als dit niet van toepassing is. |
revenue_eur.change | number of null | value min previous. |
revenue_eur.change_pct | number of null | De verandering in procenten ten opzichte van previous; null als previous 0 of null is. |
daily | array | Per dag van de periode, oudste eerst, naast de bijbehorende dag uit de vorige periode. |
daily[].date | string | De dag, YYYY-MM-DD. |
daily[].sessions | integer | Sessies. |
daily[].engaged_sessions | integer | Sessies met betrokkenheid. |
daily[].users | integer | Gebruikers. |
daily[].conversions | integer | Conversies (key events). |
daily[].previous_date | string | De bijbehorende dag uit de vorige periode, YYYY-MM-DD. |
daily[].previous_sessions | integer | Sessies op previous_date. |
daily[].previous_engaged_sessions | integer | Sessies met betrokkenheid op previous_date. |
daily[].previous_users | integer | Gebruikers op previous_date. |
daily[].previous_conversions | integer | Conversies op previous_date. |
analytics.channels
POST /rest/v1/analytics.channels · MCP-tool get_analytics_channels
Geeft de sessies van één site per kanaal (Organic Search, Direct, Referral, AI Assistant, …) in de periode, meeste sessies eerst: alle metrics, het aandeel in alle sessies en dezelfde cijfers in de vorige periode. Toont altijd elk kanaal; het filter channel werkt hier niet. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.channels \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"channel": "Organic Search",
"sessions": 742,
"engaged_sessions": 520,
"engagement_rate_pct": 70.1,
"users": 471,
"new_users": 417,
"views": 1534,
"views_per_session": 2.07,
"avg_session_duration_seconds": 183.7,
"conversions": 147,
"revenue_eur": 0,
"share_pct": 64.4,
"previous": {
"sessions": 696,
"engaged_sessions": 500,
"engagement_rate_pct": 71.8,
"users": 466,
"new_users": 421,
"views": 1508,
"views_per_session": 2.17,
"avg_session_duration_seconds": 180.7,
"conversions": 121,
"revenue_eur": 0
}
},
{
"channel": "Direct",
"sessions": 378,
"engaged_sessions": 216,
"engagement_rate_pct": 57.1,
"users": 246,
"new_users": 237,
"views": 1042,
"views_per_session": 2.76,
"avg_session_duration_seconds": 138.5,
"conversions": 140,
"revenue_eur": 0,
"share_pct": 32.8,
"previous": {
"sessions": 316,
"engaged_sessions": 188,
"engagement_rate_pct": 59.5,
"users": 197,
"new_users": 186,
"views": 838,
"views_per_session": 2.65,
"avg_session_duration_seconds": 170.7,
"conversions": 83,
"revenue_eur": 0
}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 7,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
channel | string | Het kanaal, zoals Google Analytics het noemt. |
sessions | integer | Sessies. |
engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
new_users | integer | Gebruikers die voor het eerst kwamen. |
views | integer | Paginaweergaven. |
views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
share_pct | number of null | Aandeel in de sessies van de hele lijst, 0-100. |
previous | object of null | Dezelfde cijfers in de vorige periode; null als dit toen niet voorkwam. |
previous.sessions | integer | Sessies. |
previous.engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
previous.engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
previous.users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
previous.new_users | integer | Gebruikers die voor het eerst kwamen. |
previous.views | integer | Paginaweergaven. |
previous.views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
previous.avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
previous.conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
previous.revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
analytics.sources
POST /rest/v1/analytics.sources · MCP-tool get_analytics_sources
Geeft de sessies van één site per bron / medium (google / organic, chatgpt.com / referral, (direct) / (none)) in de periode, meeste sessies eerst: alle metrics, het aandeel in de sessies in de lijst en dezelfde cijfers in de vorige periode. Gebruik channel om de bronnen van één kanaal te zien. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.sources \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"source_medium": "google / organic",
"source": "google",
"medium": "organic",
"sessions": 711,
"engaged_sessions": 496,
"engagement_rate_pct": 69.8,
"users": 448,
"new_users": 396,
"views": 1478,
"views_per_session": 2.08,
"avg_session_duration_seconds": 181.3,
"conversions": 145,
"revenue_eur": 0,
"share_pct": 61.7,
"previous": {
"sessions": 665,
"engaged_sessions": 479,
"engagement_rate_pct": 72,
"users": 443,
"new_users": 399,
"views": 1424,
"views_per_session": 2.14,
"avg_session_duration_seconds": 180.2,
"conversions": 111,
"revenue_eur": 0
}
},
{
"source_medium": "(direct) / (none)",
"source": "(direct)",
"medium": "(none)",
"sessions": 378,
"engaged_sessions": 216,
"engagement_rate_pct": 57.1,
"users": 246,
"new_users": 237,
"views": 1042,
"views_per_session": 2.76,
"avg_session_duration_seconds": 138.5,
"conversions": 140,
"revenue_eur": 0,
"share_pct": 32.8,
"previous": {
"sessions": 316,
"engaged_sessions": 188,
"engagement_rate_pct": 59.5,
"users": 197,
"new_users": 186,
"views": 838,
"views_per_session": 2.65,
"avg_session_duration_seconds": 170.7,
"conversions": 83,
"revenue_eur": 0
}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 16,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
source_medium | string | Bron / medium, zoals Google Analytics het teruggeeft; gebruik dit als het filter source_medium. |
source | string | De bron (google, chatgpt.com, (direct)). |
medium | string of null | Het medium (organic, referral, cpc, (none)); null als Google Analytics niets teruggeeft. |
sessions | integer | Sessies. |
engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
new_users | integer | Gebruikers die voor het eerst kwamen. |
views | integer | Paginaweergaven. |
views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
share_pct | number of null | Aandeel in de sessies van de hele lijst, 0-100. |
previous | object of null | Dezelfde cijfers in de vorige periode; null als dit toen niet voorkwam. |
previous.sessions | integer | Sessies. |
previous.engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
previous.engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
previous.users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
previous.new_users | integer | Gebruikers die voor het eerst kwamen. |
previous.views | integer | Paginaweergaven. |
previous.views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
previous.avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
previous.conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
previous.revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
analytics.landing_pages
POST /rest/v1/analytics.landing_pages · MCP-tool get_analytics_landing_pages
Geeft de sessies van één site per landingspagina (de eerste pagina van een sessie) in de periode, meeste sessies eerst: alle metrics, het aandeel in de sessies in de lijst en dezelfde cijfers in de vorige periode. Combineer met channel of source_medium om te zien waar een kanaal landt. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.landing_pages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"path": "/rental/tens-device",
"url": "https://www.example-shop.com/rental/tens-device",
"sessions": 414,
"engaged_sessions": 307,
"engagement_rate_pct": 74.2,
"users": 357,
"new_users": 328,
"views": 997,
"views_per_session": 2.41,
"avg_session_duration_seconds": 230.7,
"conversions": 75,
"revenue_eur": 0,
"share_pct": 35.9,
"previous": {
"sessions": 464,
"engaged_sessions": 322,
"engagement_rate_pct": 69.4,
"users": 394,
"new_users": 372,
"views": 1011,
"views_per_session": 2.18,
"avg_session_duration_seconds": 206.2,
"conversions": 68,
"revenue_eur": 0
}
},
{
"path": "/",
"url": "https://www.example-shop.com/",
"sessions": 193,
"engaged_sessions": 105,
"engagement_rate_pct": 54.4,
"users": 152,
"new_users": 110,
"views": 495,
"views_per_session": 2.56,
"avg_session_duration_seconds": 156.4,
"conversions": 12,
"revenue_eur": 0,
"share_pct": 16.8,
"previous": {
"sessions": 150,
"engaged_sessions": 97,
"engagement_rate_pct": 64.7,
"users": 125,
"new_users": 87,
"views": 394,
"views_per_session": 2.63,
"avg_session_duration_seconds": 153.2,
"conversions": 8,
"revenue_eur": 0
}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 172,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
path | string | Het pad van de landingspagina, zoals Google Analytics het teruggeeft; (not set) als het onbekend is. |
url | string of null | Het volledige adres van de pagina; null bij (not set). |
sessions | integer | Sessies. |
engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
new_users | integer | Gebruikers die voor het eerst kwamen. |
views | integer | Paginaweergaven. |
views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
share_pct | number of null | Aandeel in de sessies van de hele lijst, 0-100. |
previous | object of null | Dezelfde cijfers in de vorige periode; null als dit toen niet voorkwam. |
previous.sessions | integer | Sessies. |
previous.engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
previous.engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
previous.users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
previous.new_users | integer | Gebruikers die voor het eerst kwamen. |
previous.views | integer | Paginaweergaven. |
previous.views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
previous.avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
previous.conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
previous.revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
analytics.pages
POST /rest/v1/analytics.pages · MCP-tool get_analytics_pages
Geeft de paginaweergaven van één site per pagina (elke bekeken pagina, niet alleen landingspagina's) in de periode, meeste weergaven eerst: weergaven, de sessies en gebruikers waarin de pagina is bekeken, betrokkenheid en duur van die sessies, het aandeel in alle weergaven en dezelfde cijfers in de vorige periode. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.pages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"path": "/rental/tens-device",
"url": "https://www.example-shop.com/rental/tens-device",
"views": 597,
"sessions": 486,
"users": 396,
"engagement_rate_pct": 76.3,
"avg_session_duration_seconds": 139.4,
"share_pct": 22.4,
"previous": {
"views": 632,
"sessions": 528,
"users": 431,
"engagement_rate_pct": 71.2,
"avg_session_duration_seconds": 131
}
},
{
"path": "/cart/list",
"url": "https://www.example-shop.com/cart/list",
"views": 391,
"sessions": 78,
"users": 4,
"engagement_rate_pct": 80.8,
"avg_session_duration_seconds": 227.7,
"share_pct": 14.7,
"previous": {
"views": 372,
"sessions": 74,
"users": 3,
"engagement_rate_pct": 89.2,
"avg_session_duration_seconds": 277.5
}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 250,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
path | string | Het pad van de pagina, zoals Google Analytics het teruggeeft. |
url | string of null | Het volledige adres van de pagina; null bij (not set). |
views | integer | Paginaweergaven. |
sessions | integer | Sessies waarin de pagina is bekeken. |
users | integer | Gebruikers die de pagina hebben bekeken. |
engagement_rate_pct | number of null | Betrokkenheidspercentage van die sessies, 0-100; null zonder sessies. |
avg_session_duration_seconds | number of null | Gemiddelde duur van die sessies in seconden; null zonder sessies. |
share_pct | number of null | Aandeel in de weergaven van de hele lijst, 0-100. |
previous | object of null | Dezelfde cijfers in de vorige periode; null als de pagina toen geen weergaven had. |
previous.views | integer | Paginaweergaven. |
previous.sessions | integer | Sessies waarin de pagina is bekeken. |
previous.users | integer | Gebruikers die de pagina hebben bekeken. |
previous.engagement_rate_pct | number of null | Betrokkenheidspercentage, 0-100. |
previous.avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden. |
analytics.audience
POST /rest/v1/analytics.audience · MCP-tool get_analytics_audience
Geeft de sessies van één site per land, plaats, apparaat, browser, taal of nieuw versus terugkerend (by) in de periode, meeste sessies eerst: alle metrics, het aandeel in de sessies in de lijst en dezelfde cijfers in de vorige periode. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
by | een van country, city, device, browser, language, new_vs_returning | country, city, device (desktop, mobile, tablet), browser, language of new_vs_returning (new, returning). Standaard country. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.audience \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","by":"country","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"key": "Netherlands",
"sessions": 1023,
"engaged_sessions": 716,
"engagement_rate_pct": 70,
"users": 610,
"new_users": 552,
"views": 2488,
"views_per_session": 2.43,
"avg_session_duration_seconds": 182.9,
"conversions": 278,
"revenue_eur": 0,
"share_pct": 88.9,
"previous": {
"sessions": 964,
"engaged_sessions": 664,
"engagement_rate_pct": 68.9,
"users": 610,
"new_users": 558,
"views": 2268,
"views_per_session": 2.35,
"avg_session_duration_seconds": 188.8,
"conversions": 197,
"revenue_eur": 0
}
},
{
"key": "United States",
"sessions": 73,
"engaged_sessions": 15,
"engagement_rate_pct": 20.5,
"users": 73,
"new_users": 72,
"views": 109,
"views_per_session": 1.49,
"avg_session_duration_seconds": 7.2,
"conversions": 8,
"revenue_eur": 0,
"share_pct": 6.3,
"previous": {
"sessions": 23,
"engaged_sessions": 18,
"engagement_rate_pct": 78.3,
"users": 23,
"new_users": 23,
"views": 59,
"views_per_session": 2.57,
"avg_session_duration_seconds": 16.6,
"conversions": 8,
"revenue_eur": 0
}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 23,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
key | string | Het land, de plaats, het apparaat, de browser, de taal of new / returning, zoals Google Analytics het teruggeeft (Engelse namen). |
sessions | integer | Sessies. |
engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
new_users | integer | Gebruikers die voor het eerst kwamen. |
views | integer | Paginaweergaven. |
views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
share_pct | number of null | Aandeel in de sessies van de hele lijst, 0-100. |
previous | object of null | Dezelfde cijfers in de vorige periode; null als dit toen niet voorkwam. |
previous.sessions | integer | Sessies. |
previous.engaged_sessions | integer | Sessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie. |
previous.engagement_rate_pct | number of null | Sessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies. |
previous.users | integer | Gebruikers (actieve gebruikers, zoals Google Analytics ze telt). |
previous.new_users | integer | Gebruikers die voor het eerst kwamen. |
previous.views | integer | Paginaweergaven. |
previous.views_per_session | number of null | Paginaweergaven per sessie; null zonder sessies. |
previous.avg_session_duration_seconds | number of null | Gemiddelde sessieduur in seconden; null zonder sessies. |
previous.conversions | integer | Key events (conversies zoals ingesteld in Google Analytics). |
previous.revenue_eur | number | Omzet, in de valuta van de Google Analytics-property (meestal euro). |
analytics.events
POST /rest/v1/analytics.events · MCP-tool get_analytics_events
Geeft de events van één site per eventnaam (page_view, scroll, purchase, form_submit, …) in de periode, meeste eerst: hoe vaak, hoeveel daarvan tellen als conversies (key events), de gebruikers en de omzet, en hetzelfde in de vorige periode. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.events \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"event": "page_view",
"count": 2668,
"conversions": 0,
"users": 725,
"revenue_eur": 0,
"previous": {"count": 2379, "conversions": 0, "users": 672, "revenue_eur": 0}
},
{
"event": "user_engagement",
"count": 1991,
"conversions": 0,
"users": 509,
"revenue_eur": 0,
"previous": {"count": 1802, "conversions": 0, "users": 481, "revenue_eur": 0}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 10,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
event | string | De eventnaam. |
count | integer | Hoe vaak het event plaatsvond. |
conversions | integer | Hoeveel daarvan key events zijn (0 als het event geen key event is). |
users | integer | Gebruikers met het event. |
revenue_eur | number | Omzet bij het event, in de valuta van de property. |
previous | object of null | Hetzelfde in de vorige periode; null als het event toen niet voorkwam. |
previous.count | integer | Hoe vaak. |
previous.conversions | integer | Key events. |
previous.users | integer | Gebruikers. |
previous.revenue_eur | number | Omzet. |
analytics.products
POST /rest/v1/analytics.products · MCP-tool get_analytics_products
Geeft de e-commerceproducten van één site in de periode, meeste omzet eerst: omzet, gekochte items en bekeken items, en hetzelfde in de vorige periode. Leeg als de site geen e-commercedata naar Google Analytics stuurt. De filters werken hier niet (productdata heeft geen sessies). Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.products \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Ter illustratie: het account achter de andere voorbeelden stuurt geen e-commercedata, dus deze producten zijn fictief maar hebben exact de vorm van het antwoord.
{
"data": [
{
"product": "TENS device, 4 weeks",
"revenue_eur": 1188,
"purchased": 33,
"viewed": 412,
"previous": {"revenue_eur": 972, "purchased": 27, "viewed": 380}
},
{
"product": "Electrode pads (4 pack)",
"revenue_eur": 89.7,
"purchased": 10,
"viewed": 61,
"previous": null
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 14,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
product | string | De productnaam (itemnaam). |
revenue_eur | number | Omzet uit het product, in de valuta van de property. |
purchased | integer | Gekochte items. |
viewed | integer | Aantal keer dat het item is bekeken. |
previous | object of null | Hetzelfde in de vorige periode; null als het product toen niet voorkwam. |
previous.revenue_eur | number | Omzet. |
previous.purchased | integer | Gekochte items. |
previous.viewed | integer | Aantal keer bekeken. |
analytics.referrers
POST /rest/v1/analytics.referrers · MCP-tool get_analytics_referrers
Geeft de pagina's op andere sites die in de periode bezoekers naar één site stuurden, per verwijzende pagina en landingspagina, meeste sessies eerst: sessies, sessies met betrokkenheid en paginaweergaven, en hetzelfde in de vorige periode. Zoekmachines en de site zelf zijn weggelaten. Browsers geven vaak alleen het domein van de verwijzende site door, niet de pagina; dan is referrer_url het domein en staat domain_only op true. Combineer met source_medium (chatgpt.com / referral) voor één bron. De filters perken alles tegelijk in; meta.period geeft de periode en de vorige periode. Geeft 409 not_connected terug als Google Analytics 4 niet is gekoppeld voor de site.
Argumenten
| Argument | Type | Wat het doet |
|---|---|---|
site_id (verplicht) | string | De site: het id uit list_sites, of het id in het adres in de app. |
from | string, YYYY-MM-DD | Eerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee. |
to | string, YYYY-MM-DD | Laatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen. |
days | integer, 1 t/m 366, standaard 28 | Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28. |
compare | een van previous_period, previous_year | Waar de vorige cijfers op slaan: previous_period (hetzelfde aantal dagen direct ervoor) of previous_year (dezelfde dagen 52 weken eerder, zelfde weekdagen; voor periodes tot 364 dagen). Standaard previous_period. |
channel | string | Alleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …). |
source_medium | string | Alleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic). |
landing_page | string | Alleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post). |
path_prefix | string | Alleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/). |
country | string | Alleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands). |
device | een van desktop, mobile, tablet, smart tv | Alleen sessies op dit type apparaat. |
limit | integer, 1 t/m 500, standaard 100 | Items per call. |
cursor | string | meta.next_cursor van de vorige call, voor de volgende pagina. |
Voorbeeldrequest
curl -X POST https://app.marketingtracer.com/rest/v1/analytics.referrers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"site_id":"YOUR_SITE_ID","limit":2}'
Voorbeeldantwoord · Een echt antwoord, geanonimiseerd en ingekort tot twee items per lijst.
{
"data": [
{
"referrer_url": "https://www.example-forum.com",
"referrer_domain": "example-forum.com",
"domain_only": true,
"landing_page": "/rental/tens-device",
"landing_url": "https://www.example-shop.com/rental/tens-device",
"sessions": 7,
"engaged_sessions": 2,
"views": 8,
"previous": {"sessions": 0, "engaged_sessions": 0, "views": 0}
},
{
"referrer_url": "https://l.wl.co",
"referrer_domain": "l.wl.co",
"domain_only": true,
"landing_page": "/rental/tens-device",
"landing_url": "https://www.example-shop.com/rental/tens-device",
"sessions": 3,
"engaged_sessions": 1,
"views": 4,
"previous": {"sessions": 0, "engaged_sessions": 0, "views": 0}
}
],
"meta": {
"site_id": "YOUR_SITE_ID",
"next_cursor": "2",
"total": 5,
"period": {
"from": "2026-10-06",
"to": "2026-11-02",
"compare_from": "2026-09-08",
"compare_to": "2026-10-05"
}
}
}
Antwoordvelden · data is een lijst; elk item bevat:
| Veld | Type | Wat het is |
|---|---|---|
referrer_url | string | De verwijzende pagina zonder querystring; alleen https://domain als de browser niet meer doorgaf. |
referrer_domain | string | Het domein van de verwijzende site, zonder www. |
domain_only | boolean | Of alleen het domein van de verwijzende pagina bekend is. |
landing_page | string | Het pad van de pagina waarop de bezoeker binnenkwam. |
landing_url | string of null | Het volledige adres van die pagina; null als het onbekend is. |
sessions | integer | Sessies. |
engaged_sessions | integer | Sessies met betrokkenheid. |
views | integer | Paginaweergaven. |
previous | object of null | Hetzelfde in de vorige periode; null als dit toen niet voorkwam. |
previous.sessions | integer | Sessies. |
previous.engaged_sessions | integer | Sessies met betrokkenheid. |
previous.views | integer | Paginaweergaven. |
White-label Google Analytics 4 API. Op je eigen domein, onder je eigen naam.
Draait je white-label dashboard op je eigen domein, dan antwoorden de REST API en de MCP-server ook op dat adres. Één persoonlijke API-key werkt voor elke klantsite waar je toegang toe hebt. Je bepaalt zelf of je klanten ook toegang krijgen tot de API en de MCP.
Het online-marketing dashboard voor professionals
Meer dan de helft van de Emerce top-100 digital marketingbureaus gebruikt MarketingTracer.
- Geen creditcard nodig
- Geen installatie nodig
- Geen kleine lettertjes
Veelgestelde vragen
Andere vraag? Stel hem ons.
Zit de Google Analytics 4 API in elk pakket?
Ja. De Google Analytics 4-endpoints en MCP-tools zitten zonder meerprijs in elk pakket. Één persoonlijke API-key van de MCP-pagina in de app werkt voor zowel de REST API als de MCP-server over al je sites. Bekijk de prijzenpagina voor de pakketdetails.
Welke datumbereiken en vergelijkingen kan ik opvragen?
Geef from en to (YYYY-MM-DD) samen mee, of stel days in (standaard 28) voor een voortschrijdend venster tot en met gisteren. Vandaag telt niet mee omdat de Google Analytics 4-data van vandaag nog niet compleet is. Zet compare op previous_period voor het voorgaande venster van gelijke lengte, of op previous_year voor dezelfde dagen 52 weken eerder zodat weekdagen overeenkomen.
Hoe werken de gedeelde filters over de verschillende endpoints?
Geef elke gewenste combinatie van channel, source_medium, landing_page, path_prefix, country en device mee aan analytics.summary en de lijsten op sessieniveau. Alle filters die je meegeeft gelden tegelijk. Twee endpoints werken anders: analytics.channels toont altijd elk kanaal en negeert channel, en analytics.products accepteert geen sessiefilters omdat GA4-productrijen op itemniveau zijn.
Hoe koppel ik Claude Code of Cursor aan de Google Analytics 4 MCP-tools?
Verwijs je editor naar /rest/mcp/server op app.marketingtracer.com of op je eigen white-label domein. Geef je persoonlijke API-key van de MCP-pagina in de app mee als Bearer-token. Kant-en-klare installatiecommando's voor Claude Code en Cursor staan op de SEO MCP-pagina.
Wat is de rate limit, en kunnen gastgebruikers analytics-data uitlezen?
Je krijgt 60 calls per minuut per key voor de REST API en de MCP-server samen. Elk endpoint en elke MCP-tool is alleen-lezen, en gebruikers met gasttoegang tot een site kunnen de Google Analytics 4-endpoints ook uitlezen.
Wat gebeurt er als Google Analytics 4 niet is gekoppeld, of als een rij nul sessies heeft?
Is Google Analytics 4 niet gekoppeld voor een site, dan geeft het endpoint HTTP 409 terug met foutcode not_connected. Heeft een periode of rij 0 sessies, dan geven ratio's en gemiddelden (engagement_rate_pct, views_per_session en avg_session_duration_seconds) null terug. Bij uitsplitsingen is previous ook null als die rij niet voorkwam in het vergelijkingsvenster.
Waarom staat domain_only bij sommige rijen in analytics.referrers op true?
Veel browsers knippen bij links tussen sites het volledige pad weg uit de referrer-header en sturen alleen de origin mee. Ontvangt Google Analytics 4 alleen het domein, dan is referrer_url gelijk aan https://domain en staat domain_only op true. Gaf de browser het volledige pagina-adres door, dan staat domain_only op false.