Google PageSpeed Insights Connector Reference

7 metrics21 dimensions

The Google PageSpeed Insights connector allows to pull PageSpeed scores on a URL level.

A sample URL to retrieve the data is

https://connectors.windsor.ai/google_pagespeed?api_key=[your API key]&fields=date,timestamp,account_id,account_name,desktop_score,mobile_score,lcp,fid,cls,fcp,ttfb

The Google PageSpeed Insights connector exposes 28 fields (7 metrics, 21 dimensions). Every field ID below can be passed to the Windsor.ai API in the fields parameter.


Google PageSpeed Insights Fields

Google PageSpeed Insights DESKTOP fields

The DESKTOP report of the Google PageSpeed Insights connector includes 12 fields.

ID Type Name Description
cls NUMERIC Cumulative layout shift (CLS) Cumulative layout shift (CLS)
crux_desktop_cls NUMERIC CrUX Desktop Cumulative layout shift (CLS) Real-user desktop CLS, 75th percentile (0-1, unitless).
crux_desktop_fcp NUMERIC CrUX Desktop First contentful paint (FCP) Real-user desktop FCP, 75th percentile, in milliseconds.
crux_desktop_inp NUMERIC CrUX Desktop Interaction to next paint (INP) Real-user desktop INP, 75th percentile, in milliseconds.
crux_desktop_lcp NUMERIC CrUX Desktop Largest contentful paint (LCP) Real-user desktop LCP, 75th percentile, in milliseconds.
crux_desktop_overall_category TEXT CrUX Desktop Overall category Overall desktop CrUX category (FAST, AVERAGE or SLOW).
crux_desktop_ttfb NUMERIC CrUX Desktop Time to first byte (TTFB) Real-user desktop TTFB, 75th percentile, in milliseconds.
desktop_score NUMERIC PS Insights Desktop Score PS Insights Desktop Score
fcp NUMERIC First Contentful paint (FCP) First Contentful paint (FCP)
fid NUMERIC First input delay (FID) First input delay (FID)
lcp NUMERIC Largest contentful paint (LCP) Largest contentful paint (LCP)
ttfb NUMERIC Time to first byte (TTFB) Time to first byte (TTFB)

Google PageSpeed Insights MOBILE fields

The MOBILE report of the Google PageSpeed Insights connector includes 12 fields.

ID Type Name Description
crux_mobile_cls NUMERIC CrUX Mobile Cumulative layout shift (CLS) Real-user mobile CLS, 75th percentile (0-1, unitless).
crux_mobile_fcp NUMERIC CrUX Mobile First contentful paint (FCP) Real-user mobile FCP, 75th percentile, in milliseconds.
crux_mobile_inp NUMERIC CrUX Mobile Interaction to next paint (INP) Real-user mobile INP, 75th percentile, in milliseconds.
crux_mobile_lcp NUMERIC CrUX Mobile Largest contentful paint (LCP) Real-user mobile LCP, 75th percentile, in milliseconds.
crux_mobile_overall_category TEXT CrUX Mobile Overall category Overall mobile CrUX category (FAST, AVERAGE or SLOW).
crux_mobile_ttfb NUMERIC CrUX Mobile Time to first byte (TTFB) Real-user mobile TTFB, 75th percentile, in milliseconds.
mobile_cls NUMERIC Mobile Cumulative layout shift (CLS) Cumulative layout shift (CLS) from the mobile lab test.
mobile_fcp NUMERIC Mobile First contentful paint (FCP) First contentful paint (FCP) from the mobile lab test.
mobile_fid NUMERIC Mobile First input delay (FID) First input delay (FID) from the mobile lab test.
mobile_lcp NUMERIC Mobile Largest contentful paint (LCP) Largest contentful paint (LCP) from the mobile lab test.
mobile_score NUMERIC PS Insights Mobile Score PS Insights Mobile Score
mobile_ttfb NUMERIC Mobile Time to first byte (TTFB) Time to first byte (TTFB) from the mobile lab test.

Google PageSpeed Insights other fields

The Google PageSpeed Insights connector has 22 fields that do not belong to a named report, or belong to a report with only one or two fields.

ID Type Name Description Report
account_id TEXT Account ID URL of the page
account_name TEXT Account Name URL of the page
data_fetched_at TIMESTAMP Data fetched at UTC timestamp (second precision) of when the connector request that pulled the row started. Freshly pulled rows show this request's start time; cache hits keep the start time of the request that filled the cache. Selecting this field disables aggregation, so rows are returned individually (each keeping its own fetch time) instead of being summed.
datasource TEXT Data Source The name of the Windsor connector returning the row
date DATE Date The Date
day_of_month TEXT Day of month Day of the month
month TEXT Month Number of the month
now TIMESTAMP Now Current timestamp
source TEXT Source The name of the Windsor connector returning the row
timestamp TIMESTAMP Timestamp Timestamp
today DATE Today Today's date
week TEXT Week Week (Sun-Sat).
week_day TEXT Day of week and day number Weekday number and name combined (Sun-Sat).Numbered from 0 Sunday to 6 Saturday.
week_day_iso TEXT Day of week and day number, ISO Weekday number and name combined, ISO format (Mon-Sun).Numbered from 1 Monday to 7
week_iso TEXT Week ISO Week, ISO format (Mon-Sun).
year TEXT Year Year
year_month TEXT Yearmonth Year and month, e.g. 2024|3
year_month_name TEXT Year month name Year and month with the month name written out, e.g. "Jan 2025".
year_of_week TEXT Year of week The year that contains first day of the week (Sun-Sat).
year_of_week_iso TEXT Year of week, ISO The year that contains first day of the ISO week (Mon-Sun).
year_week TEXT Year week Year and week for US weeks (Sun-Sat), e.g. 2024|15
year_week_iso TEXT Year week ISO Year and week for ISO weeks (Mon-Sun), e.g. 2024|20