Google PageSpeed Insights Connector Reference
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 | 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 | Now | Current timestamp | ||
| source | TEXT | Source | The name of the Windsor connector returning the row | |
| 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 |
Windsor vs Coupler.io
