NIEUWAI content checker: zie welke pagina's als AI-tekst lezen

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.

EndpointMCP-toolWat het teruggeeft
analytics.summaryget_analytics_summarySitetotalen 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.channelsget_analytics_channelsSessies, 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.sourcesget_analytics_sourcesDe overzichtscijfers per bron en medium (zoals google / organic of chatgpt.com / referral), aandeel in de sessies en cijfers uit de vorige periode.
analytics.landing_pagesget_analytics_landing_pagesDe overzichtscijfers per instappaginapad en volledige URL, aandeel in de sessies en cijfers uit de vorige periode.
analytics.pagesget_analytics_pagesPaginaweergaven, sessies, gebruikers, betrokkenheidspercentage en gemiddelde sessieduur per bekeken paginapad en URL, plus aandeel in de weergaven en cijfers uit de vorige periode.
analytics.audienceget_analytics_audienceDe overzichtscijfers per land, plaats, apparaat, browser, taal of new_vs_returning, met aandeel in de sessies en cijfers uit de vorige periode.
analytics.eventsget_analytics_eventsAantal events, key-event-conversies, gebruikers en omzet per GA4-eventnaam, naast de vorige periode.
analytics.productsget_analytics_productsE-commerce-productomzet, gekochte items en bekeken items per productnaam, naast de vorige periode.
analytics.referrersget_analytics_referrersExterne 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.

Welke mobiele landingspagina's onder /rental/ zijn deze maand gegroeid in google / organic?
get_analytics_landing_pages
source_mediumpath_prefixdevicesessionsconversionsprevious

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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen 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:

VeldTypeWat het is
comparestringprevious_period of previous_year: waar de vorige cijfers op slaan.
sessionsobjectSessies in de periode, afgezet tegen de vorige periode.
sessions.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
sessions.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
sessions.changenumber of nullvalue min previous.
sessions.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
engaged_sessionsobjectSessies met betrokkenheid in de periode, afgezet tegen de vorige periode.
engaged_sessions.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
engaged_sessions.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
engaged_sessions.changenumber of nullvalue min previous.
engaged_sessions.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
engagement_rate_pctobjectBetrokkenheidspercentage, 0-100, in de periode, afgezet tegen de vorige periode.
engagement_rate_pct.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
engagement_rate_pct.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
engagement_rate_pct.changenumber of nullvalue min previous, in procentpunten.
engagement_rate_pct.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
usersobjectGebruikers in de periode, afgezet tegen de vorige periode.
users.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
users.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
users.changenumber of nullvalue min previous.
users.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
new_usersobjectNieuwe gebruikers in de periode, afgezet tegen de vorige periode.
new_users.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
new_users.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
new_users.changenumber of nullvalue min previous.
new_users.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
viewsobjectPaginaweergaven in de periode, afgezet tegen de vorige periode.
views.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
views.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
views.changenumber of nullvalue min previous.
views.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
views_per_sessionobjectPaginaweergaven per sessie in de periode, afgezet tegen de vorige periode.
views_per_session.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
views_per_session.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
views_per_session.changenumber of nullvalue min previous.
views_per_session.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
avg_session_duration_secondsobjectGemiddelde sessieduur in seconden in de periode, afgezet tegen de vorige periode.
avg_session_duration_seconds.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
avg_session_duration_seconds.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
avg_session_duration_seconds.changenumber of nullvalue min previous.
avg_session_duration_seconds.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
conversionsobjectConversies (key events) in de periode, afgezet tegen de vorige periode.
conversions.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
conversions.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
conversions.changenumber of nullvalue min previous.
conversions.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
revenue_eurobjectOmzet in de periode, afgezet tegen de vorige periode.
revenue_eur.valuenumber of nullDeze periode; null als dit niet van toepassing is (geen sessies).
revenue_eur.previousnumber of nullDe vorige periode; null als dit niet van toepassing is.
revenue_eur.changenumber of nullvalue min previous.
revenue_eur.change_pctnumber of nullDe verandering in procenten ten opzichte van previous; null als previous 0 of null is.
dailyarrayPer dag van de periode, oudste eerst, naast de bijbehorende dag uit de vorige periode.
daily[].datestringDe dag, YYYY-MM-DD.
daily[].sessionsintegerSessies.
daily[].engaged_sessionsintegerSessies met betrokkenheid.
daily[].usersintegerGebruikers.
daily[].conversionsintegerConversies (key events).
daily[].previous_datestringDe bijbehorende dag uit de vorige periode, YYYY-MM-DD.
daily[].previous_sessionsintegerSessies op previous_date.
daily[].previous_engaged_sessionsintegerSessies met betrokkenheid op previous_date.
daily[].previous_usersintegerGebruikers op previous_date.
daily[].previous_conversionsintegerConversies 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
channelstringHet kanaal, zoals Google Analytics het noemt.
sessionsintegerSessies.
engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
new_usersintegerGebruikers die voor het eerst kwamen.
viewsintegerPaginaweergaven.
views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
revenue_eurnumberOmzet, in de valuta van de Google Analytics-property (meestal euro).
share_pctnumber of nullAandeel in de sessies van de hele lijst, 0-100.
previousobject of nullDezelfde cijfers in de vorige periode; null als dit toen niet voorkwam.
previous.sessionsintegerSessies.
previous.engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
previous.engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
previous.usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
previous.new_usersintegerGebruikers die voor het eerst kwamen.
previous.viewsintegerPaginaweergaven.
previous.views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
previous.avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
previous.conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
previous.revenue_eurnumberOmzet, 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
source_mediumstringBron / medium, zoals Google Analytics het teruggeeft; gebruik dit als het filter source_medium.
sourcestringDe bron (google, chatgpt.com, (direct)).
mediumstring of nullHet medium (organic, referral, cpc, (none)); null als Google Analytics niets teruggeeft.
sessionsintegerSessies.
engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
new_usersintegerGebruikers die voor het eerst kwamen.
viewsintegerPaginaweergaven.
views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
revenue_eurnumberOmzet, in de valuta van de Google Analytics-property (meestal euro).
share_pctnumber of nullAandeel in de sessies van de hele lijst, 0-100.
previousobject of nullDezelfde cijfers in de vorige periode; null als dit toen niet voorkwam.
previous.sessionsintegerSessies.
previous.engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
previous.engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
previous.usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
previous.new_usersintegerGebruikers die voor het eerst kwamen.
previous.viewsintegerPaginaweergaven.
previous.views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
previous.avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
previous.conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
previous.revenue_eurnumberOmzet, 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
pathstringHet pad van de landingspagina, zoals Google Analytics het teruggeeft; (not set) als het onbekend is.
urlstring of nullHet volledige adres van de pagina; null bij (not set).
sessionsintegerSessies.
engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
new_usersintegerGebruikers die voor het eerst kwamen.
viewsintegerPaginaweergaven.
views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
revenue_eurnumberOmzet, in de valuta van de Google Analytics-property (meestal euro).
share_pctnumber of nullAandeel in de sessies van de hele lijst, 0-100.
previousobject of nullDezelfde cijfers in de vorige periode; null als dit toen niet voorkwam.
previous.sessionsintegerSessies.
previous.engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
previous.engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
previous.usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
previous.new_usersintegerGebruikers die voor het eerst kwamen.
previous.viewsintegerPaginaweergaven.
previous.views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
previous.avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
previous.conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
previous.revenue_eurnumberOmzet, 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
pathstringHet pad van de pagina, zoals Google Analytics het teruggeeft.
urlstring of nullHet volledige adres van de pagina; null bij (not set).
viewsintegerPaginaweergaven.
sessionsintegerSessies waarin de pagina is bekeken.
usersintegerGebruikers die de pagina hebben bekeken.
engagement_rate_pctnumber of nullBetrokkenheidspercentage van die sessies, 0-100; null zonder sessies.
avg_session_duration_secondsnumber of nullGemiddelde duur van die sessies in seconden; null zonder sessies.
share_pctnumber of nullAandeel in de weergaven van de hele lijst, 0-100.
previousobject of nullDezelfde cijfers in de vorige periode; null als de pagina toen geen weergaven had.
previous.viewsintegerPaginaweergaven.
previous.sessionsintegerSessies waarin de pagina is bekeken.
previous.usersintegerGebruikers die de pagina hebben bekeken.
previous.engagement_rate_pctnumber of nullBetrokkenheidspercentage, 0-100.
previous.avg_session_duration_secondsnumber of nullGemiddelde 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
byeen van country, city, device, browser, language, new_vs_returningcountry, city, device (desktop, mobile, tablet), browser, language of new_vs_returning (new, returning). Standaard country.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
keystringHet land, de plaats, het apparaat, de browser, de taal of new / returning, zoals Google Analytics het teruggeeft (Engelse namen).
sessionsintegerSessies.
engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
new_usersintegerGebruikers die voor het eerst kwamen.
viewsintegerPaginaweergaven.
views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
revenue_eurnumberOmzet, in de valuta van de Google Analytics-property (meestal euro).
share_pctnumber of nullAandeel in de sessies van de hele lijst, 0-100.
previousobject of nullDezelfde cijfers in de vorige periode; null als dit toen niet voorkwam.
previous.sessionsintegerSessies.
previous.engaged_sessionsintegerSessies met betrokkenheid: langer dan 10 seconden, twee of meer paginaweergaven, of een conversie.
previous.engagement_rate_pctnumber of nullSessies met betrokkenheid als aandeel van de sessies, 0-100; null zonder sessies.
previous.usersintegerGebruikers (actieve gebruikers, zoals Google Analytics ze telt).
previous.new_usersintegerGebruikers die voor het eerst kwamen.
previous.viewsintegerPaginaweergaven.
previous.views_per_sessionnumber of nullPaginaweergaven per sessie; null zonder sessies.
previous.avg_session_duration_secondsnumber of nullGemiddelde sessieduur in seconden; null zonder sessies.
previous.conversionsintegerKey events (conversies zoals ingesteld in Google Analytics).
previous.revenue_eurnumberOmzet, 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
eventstringDe eventnaam.
countintegerHoe vaak het event plaatsvond.
conversionsintegerHoeveel daarvan key events zijn (0 als het event geen key event is).
usersintegerGebruikers met het event.
revenue_eurnumberOmzet bij het event, in de valuta van de property.
previousobject of nullHetzelfde in de vorige periode; null als het event toen niet voorkwam.
previous.countintegerHoe vaak.
previous.conversionsintegerKey events.
previous.usersintegerGebruikers.
previous.revenue_eurnumberOmzet.

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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
productstringDe productnaam (itemnaam).
revenue_eurnumberOmzet uit het product, in de valuta van de property.
purchasedintegerGekochte items.
viewedintegerAantal keer dat het item is bekeken.
previousobject of nullHetzelfde in de vorige periode; null als het product toen niet voorkwam.
previous.revenue_eurnumberOmzet.
previous.purchasedintegerGekochte items.
previous.viewedintegerAantal 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

ArgumentTypeWat het doet
site_id (verplicht)stringDe site: het id uit list_sites, of het id in het adres in de app.
fromstring, YYYY-MM-DDEerste dag van de periode, YYYY-MM-DD; geef deze samen met to mee.
tostring, YYYY-MM-DDLaatste dag van de periode, YYYY-MM-DD (uiterlijk gisteren); geef deze samen met from mee. Maximaal 366 dagen.
daysinteger, 1 t/m 366, standaard 28Zonder from en to: dit aantal laatste dagen tot en met gisteren. Standaard 28.
compareeen van previous_period, previous_yearWaar 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.
channelstringAlleen sessies uit dit kanaal, zoals Google Analytics het noemt (Organic Search, Direct, Referral, Organic Social, Paid Search, Email, AI Assistant, …).
source_mediumstringAlleen sessies van deze bron / dit medium, precies zoals in analytics.sources (google / organic).
landing_pagestringAlleen sessies die op deze pagina zijn gestart: het pad, precies zoals in analytics.landing_pages (/blog/post).
path_prefixstringAlleen sessies die zijn gestart op een pagina waarvan het pad hiermee begint (/blog/).
countrystringAlleen sessies uit dit land, in het Engels zoals in analytics.audience (Netherlands).
deviceeen van desktop, mobile, tablet, smart tvAlleen sessies op dit type apparaat.
limitinteger, 1 t/m 500, standaard 100Items per call.
cursorstringmeta.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:

VeldTypeWat het is
referrer_urlstringDe verwijzende pagina zonder querystring; alleen https://domain als de browser niet meer doorgaf.
referrer_domainstringHet domein van de verwijzende site, zonder www.
domain_onlybooleanOf alleen het domein van de verwijzende pagina bekend is.
landing_pagestringHet pad van de pagina waarop de bezoeker binnenkwam.
landing_urlstring of nullHet volledige adres van die pagina; null als het onbekend is.
sessionsintegerSessies.
engaged_sessionsintegerSessies met betrokkenheid.
viewsintegerPaginaweergaven.
previousobject of nullHetzelfde in de vorige periode; null als dit toen niet voorkwam.
previous.sessionsintegerSessies.
previous.engaged_sessionsintegerSessies met betrokkenheid.
previous.viewsintegerPaginaweergaven.
White-label / bureau

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.

API-hubSEO API-overzicht MCPGoogle Search Console MCP Verkeer uit AI-assistentenAI-zichtbaarheids-API MCPSEO MCP-server

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
Start nu jouw 14-dagen trial

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.