nodejs.org icon indicating copy to clipboard operation
nodejs.org copied to clipboard

Website documentation search metrics

Open marco-ippolito opened this issue 4 months ago • 6 comments

I think it would be useful to have the metrics about documentation search. This would allows us to know which part of the docs are being searched more/have more traffic. For example I'd like to know if user are searching for type stripping or node.config.json.

marco-ippolito avatar Oct 06 '25 15:10 marco-ippolito

I believe the foundation has access to the search engine data (cc @ryanaslett, iirc)

And @nodejs/web-infra has the on site search data

avivkeller avatar Oct 06 '25 15:10 avivkeller

web-infra should hopefully soon also have access to search engine data: https://github.com/nodejs/build/issues/4127

MattIPv4 avatar Oct 06 '25 15:10 MattIPv4

orama would have this potentially?

bmuenzenmeyer avatar Oct 06 '25 20:10 bmuenzenmeyer

The search data that we have access to is the Google Search Console, which is information about what people are googling.

You can filter the query data, but it might be more of a 'walk around in the data to find what you want'

What we don't know is who's asking their LLM's about type stripping or node.config.json, which makes analysis of this somewhat challenging. Cant necessarily assume that google search data is a representative sample of what users are doing.

Image Image

ryanaslett avatar Oct 06 '25 20:10 ryanaslett

orama would have this potentially?

ping @micheleriva

marco-ippolito avatar Oct 07 '25 04:10 marco-ippolito

We can definitely provide these metrics if you like! We have a PR open (#8175) and it would be easier for us to deliver these metrics once that PR is merged, since it migrates the Node.js website to the new Orama infra.

Aside from that, please let me know if there's any specific metric you'd like us to track!

micheleriva avatar Oct 07 '25 04:10 micheleriva

Hey @marco-ippolito! Sorry for the extended delay here. The data that we have is as follows:


From Orama:

Image

(Orama might have better data than what I can see in the dashboard)


From Google Search Console:

Image Image

The attached ZIP file is an export from Google Search Console of much more data regarding any URLs beginning in nodejs.org/docs, with data extending back 3 months. The two files you are looking for are Pages and Queries

nodejs.org-Performance-on-Search-2025-12-26.zip

avivkeller avatar Dec 27 '25 00:12 avivkeller

Let me know if you'd like older data. Google Search Console allows exports of up to the past 16 months

avivkeller avatar Dec 27 '25 00:12 avivkeller