Google PageSpeed · Schema

PageSpeed Insights Result

Schema for the response from the PageSpeed Insights API, containing Lighthouse audit scores, Core Web Vitals metrics, and optimization recommendations.

Core Web VitalsGoogleLighthousePage SpeedSEOWeb Performance

Properties

Name Type Description
id string The URL that was analyzed
loadingExperience object
originLoadingExperience object
lighthouseResult object
analysisUTCTimestamp string UTC timestamp of when the analysis was run
View JSON Schema on GitHub

JSON Schema

google-pagespeed-result-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://googleapis.com/schemas/pagespeed/result.json",
  "title": "PageSpeed Insights Result",
  "description": "Schema for the response from the PageSpeed Insights API, containing Lighthouse audit scores, Core Web Vitals metrics, and optimization recommendations.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uri",
      "description": "The URL that was analyzed"
    },
    "loadingExperience": {
      "$ref": "#/$defs/LoadingExperience"
    },
    "originLoadingExperience": {
      "$ref": "#/$defs/LoadingExperience"
    },
    "lighthouseResult": {
      "$ref": "#/$defs/LighthouseResult"
    },
    "analysisUTCTimestamp": {
      "type": "string",
      "format": "date-time",
      "description": "UTC timestamp of when the analysis was run"
    }
  },
  "$defs": {
    "LoadingExperience": {
      "type": "object",
      "description": "Chrome User Experience Report field data for the page or origin",
      "properties": {
        "id": {
          "type": "string"
        },
        "metrics": {
          "type": "object",
          "properties": {
            "LARGEST_CONTENTFUL_PAINT_MS": {
              "$ref": "#/$defs/Metric"
            },
            "FIRST_INPUT_DELAY_MS": {
              "$ref": "#/$defs/Metric"
            },
            "CUMULATIVE_LAYOUT_SHIFT_SCORE": {
              "$ref": "#/$defs/Metric"
            },
            "INTERACTION_TO_NEXT_PAINT": {
              "$ref": "#/$defs/Metric"
            },
            "FIRST_CONTENTFUL_PAINT_MS": {
              "$ref": "#/$defs/Metric"
            }
          }
        },
        "overall_category": {
          "type": "string",
          "enum": ["FAST", "AVERAGE", "SLOW", "NONE"]
        }
      }
    },
    "Metric": {
      "type": "object",
      "description": "A Core Web Vitals metric with distribution data",
      "properties": {
        "percentile": {
          "type": "integer",
          "description": "The metric value at the 75th percentile"
        },
        "distributions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "min": { "type": "integer" },
              "max": { "type": "integer" },
              "proportion": { "type": "number" }
            }
          }
        },
        "category": {
          "type": "string",
          "enum": ["FAST", "AVERAGE", "SLOW"]
        }
      }
    },
    "LighthouseResult": {
      "type": "object",
      "description": "Lighthouse audit results",
      "properties": {
        "requestedUrl": {
          "type": "string",
          "format": "uri"
        },
        "finalUrl": {
          "type": "string",
          "format": "uri"
        },
        "lighthouseVersion": {
          "type": "string"
        },
        "fetchTime": {
          "type": "string",
          "format": "date-time"
        },
        "categories": {
          "type": "object",
          "properties": {
            "performance": { "$ref": "#/$defs/Category" },
            "accessibility": { "$ref": "#/$defs/Category" },
            "best-practices": { "$ref": "#/$defs/Category" },
            "seo": { "$ref": "#/$defs/Category" }
          }
        },
        "audits": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/$defs/Audit"
          }
        }
      }
    },
    "Category": {
      "type": "object",
      "properties": {
        "id": { "type": "string" },
        "title": { "type": "string" },
        "score": {
          "type": "number",
          "minimum": 0,
          "maximum": 1,
          "description": "Category score from 0 to 1"
        }
      }
    },
    "Audit": {
      "type": "object",
      "properties": {
        "id": { "type": "string" },
        "title": { "type": "string" },
        "description": { "type": "string" },
        "score": { "type": "number" },
        "displayValue": { "type": "string" },
        "numericValue": { "type": "number" },
        "numericUnit": { "type": "string" }
      }
    }
  }
}