Marketing & analytics Available
SE Ranking
SE Ranking supplies most of what a monthly client report is made of: where a client's keywords sit, what the site audit found, and whether the client turns up in AI answers. One key per agency covers every client project.
What you need
- An SE Ranking account with a project per client you want to report on
- An API key from that account
- The Marketing module switched on under Instellingen → Modules, with a licence covering it
- The marketing.link.manage permission to store the key and link projects
How to connect it
- 1 Switch Marketing on under Instellingen → Modules (Settings → Modules). Without a covering licence the module goes read-only after the grace period and the nightly sync stands down; everything already collected stays readable.
- 2 Go to Instellingen → Marketing (Settings → Marketing) and paste your key into SE Ranking API-sleutel. It is stored encrypted and never handed back to the browser; leave the field empty on a later save to keep the stored key.
- 3 Link each client's SE Ranking project. That link is made over the API today (
POST /api/v1/marketing/linkswithsource=seranking, andGET /api/v1/marketing/accounts?source=serankingfor the project list); the picker in the Marketing panel currently offers the three Google sources. - 4 Linking kicks off a backfill of roughly thirteen months, so trend lines and year-on-year comparisons are right from day one. After that the nightly sync re-pulls the last few days and upserts each date on the same key, so late corrections heal themselves.
- 5 Read the figures on the client's Marketing tab (the panel on the client page shows only the three Google sources today): the tiles Gem. positie, Top 3, Top 10, Top 30, Scorende zoekwoorden and Gevolgde zoekwoorden, with drill-downs Zoekwoorden, Zoekwoordgroepen, Website-audit and Zichtbaarheid in AI-zoekresultaten.
- 6 With the Rapportage module licensed, the same sources become chapters in the monthly report: Zoekwoordposities, Zichtbaarheid in AI-zoekresultaten and, in the internal version only, Website-audit.
One key for the agency, no per-employee connection
Google sources hang off one colleague's personal grant, with scopes, revocation and a reconnect prompt. SE Ranking has none of that: there is one key per organisation, and it is configured or it is not. That removes a whole class of misdirection, because a missing agency key is an admin's job in Instellingen, not something an employee fixes by signing in again. If SE Ranking rejects the key (a 401 or 403) the screen says exactly that and points at Instellingen; any other failure keeps the neutral message, because guessing helps nobody.
Stored daily, fetched per report
Only the daily figures go into storage: one small row per link per day carrying the average position, the top 3, 10 and 30, and how many keywords rank against how many are tracked. Per-keyword detail, the audit and the AI figures are fetched live when you ask for them, and a report freezes them into its own snapshot. The daily figures are folded out of exactly the same response the report table uses, so an average on a screen and the same average on paper cannot drift apart.
There is no position zero
SE Ranking reports a keyword that ranks nowhere as position 0. That number is kept out of every average: a keyword entering the top 10 from nothing would otherwise drag the average towards zero, and a client would look better the worse things got. In the report table an improvement is a positive number even though the rank goes down, and the table carries the keywords that sat in the top 25 at either the start or the end of the period. Rows are grouped the way you grouped them in SE Ranking itself.
- Positions are read per search engine, so a client tracking Google NL and Google BE counts both
- The report table is capped at 200 keywords; a truncation is reported on the run's warnings, never on the client's document
- The Zoekwoordgroepen drill-down rolls the same rows up per theme: keyword count, how many sit in the top 10, and the average position
The audit and the AI tracker
The audit read is the latest finished audit for that project, found by project id and never by fuzzy-matching a domain across your whole account. Out of it come the score, the number of pages crawled, the counts of errors, warnings and notices, and the findings themselves with the number of affected pages each, sorted by severity. Finding names arrive in your SE Ranking account's own language and are passed through untranslated: it is their text, not ours. From the AI Result Tracker comes, per configured engine, how often you are linked and mentioned in answers, with the change against the previous measurement.
Permissions
Grant these to the role that manages this integration (Settings → Roles). Admin-only by default, and never to the client role.
-
marketing.link.manageStore the SE Ranking key and link or unlink client projects. Admin only by default. -
marketing.metrics.readSee the figures on a client's Marketing tab. Admin, member and the client role by default. -
marketing.overview.readRead the cross-client overview, with average position as a column.
What it deliberately does not do
- Linking a client project runs over the API today; the picker in the Marketing panel offers the three Google sources.
- No per-keyword history is warehoused. Only the daily figures are stored; the detail arrives live and afterwards lives on only inside a report's snapshot.
- schakl. reads SE Ranking and never writes to it: no adding keywords, no starting an audit, no creating a project.
- The site audit is an internal chapter and never appears in the document a client reads.
- If SE Ranking refuses your key, look first at the shape of the authorization header and at the project-list path: those are the two places accounts can differ. Everything around them parses defensively, so a mismatch there surfaces as an empty list rather than a half-filled one.
Where to find it Instellingen → Marketing (Settings → Marketing) for the key, the Marketing tab on a client for the figures, and the chapters inside Rapportages (Reports).
Read the guide