Pagespeedapi: runpagespeed

    • Analyzes a webpage's performance and provides PageSpeed scores.

    • Offers suggestions to improve page loading speed based on the analysis.

    • Returns information about user experience metrics such as loading time.

    • Allows specifying the analysis strategy for desktop or mobile devices.

    • Uses Lighthouse to perform a comprehensive audit of the given URL.

    Runs PageSpeed analysis on the page at the specified URL, and returns PageSpeed scores, a list of suggestions to make that page faster, and other information. Try it now .

    Request

    HTTP request

    GET https://www.googleapis.com/pagespeedonline/v5/runPagespeed

    Parameters

    Parameter name
    Value
    Description
    Required query parameters
    url
    string
    The URL to fetch and analyze
    Optional query parameters
    category
    string
    A Lighthouse category to run; if none are given, only Performance category will be run

    Acceptable values are:
    • " accessibility "
    • " best-practices "
    • " performance "
    • " seo "
    locale
    string
    The locale used to localize formatted results
    strategy
    string
    The analysis strategy (desktop or mobile) to use, and desktop is the default

    Acceptable values are:
    • " desktop ": Fetch and analyze the URL for desktop browsers
    • " mobile ": Fetch and analyze the URL for mobile devices
    utm_campaign
    string
    Campaign name for analytics.
    utm_source
    string
    Campaign source for analytics.

    Request body

    Do not supply a request body with this method.

    Response

    If successful, this method returns a response body with the following structure:

    {  
 "captchaResult" 
 : 
  
  string 
 
 , 
  
 "kind" 
 : 
  
 "pagespeedonline#result" 
 , 
  
 "id" 
 : 
  
  string 
 
 , 
  
 "loadingExperience" 
 : 
  
{  
 "id" 
 : 
  
  string 
 
 , 
  
 "metrics" 
 : 
  
{  
  ( 
 key 
 ) 
 
:  
{  
 "percentile" 
 : 
  
  integer 
 
 , 
  
 "distributions" 
 : 
  
 [ 
  
{  
 "min" 
 : 
  
  integer 
 
 , 
  
 "max" 
 : 
  
  integer 
 
 , 
  
 "proportion" 
 : 
  
  double 
 
  
}  
 ], 
  
 "category" 
 : 
  
  string 
 
  
}  
} , 
  
 "overall_category" 
 : 
  
  string 
 
 , 
  
 "initial_url" 
 : 
  
  string 
 
  
} , 
  
 "originLoadingExperience" 
 : 
  
{  
 "id" 
 : 
  
  string 
 
 , 
  
 "metrics" 
 : 
  
{  
  ( 
 key 
 ) 
 
:  
{  
 "percentile" 
 : 
  
  integer 
 
 , 
  
 "distributions" 
 : 
  
 [ 
  
{  
 "min" 
 : 
  
  integer 
 
 , 
  
 "max" 
 : 
  
  integer 
 
 , 
  
 "proportion" 
 : 
  
  double 
 
  
}  
 ], 
  
 "category" 
 : 
  
  string 
 
  
}  
} , 
  
 "overall_category" 
 : 
  
  string 
 
 , 
  
 "initial_url" 
 : 
  
  string 
 
  
} , 
  
 "lighthouseResult" 
 : 
  
{  
 "requestedUrl" 
 : 
  
  string 
 
 , 
  
 "finalUrl" 
 : 
  
  string 
 
 , 
  
 "lighthouseVersion" 
 : 
  
  string 
 
 , 
  
 "userAgent" 
 : 
  
  string 
 
 , 
  
 "fetchTime" 
 : 
  
  string 
 
 , 
  
 "environment" 
 : 
  
{  
 "networkUserAgent" 
 : 
  
  string 
 
 , 
  
 "hostUserAgent" 
 : 
  
  string 
 
 , 
  
 "benchmarkIndex" 
 : 
  
  double 
 
  
} , 
  
 "runWarnings" 
 : 
  
 [ 
  
  ( 
 value 
 ) 
 
  
 ], 
  
 "configSettings" 
 : 
  
{  
 "emulatedFormFactor" 
 : 
  
  string 
 
 , 
  
 "locale" 
 : 
  
  string 
 
 , 
  
 "onlyCategories" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "onlyCategories" 
 : 
  
  ( 
 value 
 ) 
 
  
} , 
  
 "audits" 
 : 
  
{  
  ( 
 key 
 ) 
 
:  
{  
 "id" 
 : 
  
  string 
 
 , 
  
 "title" 
 : 
  
  string 
 
 , 
  
 "description" 
 : 
  
  string 
 
 , 
  
 "score" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "score" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "scoreDisplayMode" 
 : 
  
  string 
 
 , 
  
 "displayValue" 
 : 
  
  string 
 
 , 
  
 "explanation" 
 : 
  
  string 
 
 , 
  
 "errorMessage" 
 : 
  
  string 
 
 , 
  
 "warnings" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "warnings" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "details" 
 : 
  
{  
  ( 
 key 
 ) 
 
:  
  ( 
 value 
 ) 
 
  
}  
}  
} , 
  
 "categories" 
 : 
  
{  
  ( 
 key 
 ) 
 
:  
{  
 "id" 
 : 
  
  string 
 
 , 
  
 "title" 
 : 
  
  string 
 
 , 
  
 "description" 
 : 
  
  string 
 
 , 
  
 "score" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "score" 
 : 
  
  ( 
 value 
 ) 
 
,  
 "manualDescription" 
 : 
  
  string 
 
 , 
  
 "auditRefs" 
 : 
  
 [ 
  
{  
 "id" 
 : 
  
  string 
 
 , 
  
 "weight" 
 : 
  
  double 
 
 , 
  
 "group" 
 : 
  
  string 
 
  
}  
 ] 
  
}  
} , 
  
 "categoryGroups" 
 : 
  
{  
  ( 
 key 
 ) 
 
:  
{  
 "title" 
 : 
  
  string 
 
 , 
  
 "description" 
 : 
  
  string 
 
  
}  
} , 
  
 "runtimeError" 
 : 
  
{  
 "code" 
 : 
  
  string 
 
 , 
  
 "message" 
 : 
  
  string 
 
  
} , 
  
 "timing" 
 : 
  
{  
 "total" 
 : 
  
  double 
 
  
} , 
  
 "i18n" 
 : 
  
{  
 "rendererFormattedStrings" 
 : 
  
{  
 "varianceDisclaimer" 
 : 
  
  string 
 
 , 
  
 "opportunityResourceColumnLabel" 
 : 
  
  string 
 
 , 
  
 "opportunitySavingsColumnLabel" 
 : 
  
  string 
 
 , 
  
 "errorMissingAuditInfo" 
 : 
  
  string 
 
 , 
  
 "errorLabel" 
 : 
  
  string 
 
 , 
  
 "warningHeader" 
 : 
  
  string 
 
 , 
  
 "auditGroupExpandTooltip" 
 : 
  
  string 
 
 , 
  
 "passedAuditsGroupTitle" 
 : 
  
  string 
 
 , 
  
 "notApplicableAuditsGroupTitle" 
 : 
  
  string 
 
 , 
  
 "manualAuditsGroupTitle" 
 : 
  
  string 
 
 , 
  
 "toplevelWarningsMessage" 
 : 
  
  string 
 
 , 
  
 "scorescaleLabel" 
 : 
  
  string 
 
 , 
  
 "crcLongestDurationLabel" 
 : 
  
  string 
 
 , 
  
 "crcInitialNavigation" 
 : 
  
  string 
 
 , 
  
 "lsPerformanceCategoryDescription" 
 : 
  
  string 
 
 , 
  
 "labDataTitle" 
 : 
  
  string 
 
  
}  
}  
} , 
  
 "analysisUTCTimestamp" 
 : 
  
  string 
 
 , 
  
 "version" 
 : 
  
{  
 "major" 
 : 
  
  integer 
 
 , 
  
 "minor" 
 : 
  
  integer 
 
  
}
}
    Property name
    Value
    Description
    Notes
    captchaResult
    string
    The captcha verify result

    Acceptable values are:
    • " CAPTCHA_BLOCKING "
    • " CAPTCHA_MATCHED "
    • " CAPTCHA_NEEDED "
    • " CAPTCHA_NOT_NEEDED "
    • " CAPTCHA_UNMATCHED "
    kind
    string
    Kind of result.
    id
    string
    Canonicalized and final URL for the document, after following page redirects (if any).
    loadingExperience
    nested object
    Metrics of end users' page loading experience.
    loadingExperience. id
    string
    The url, pattern or origin which the metrics are on.
    loadingExperience. metrics
    object
    loadingExperience.metrics. (key)
    object
    The type of the metric.
    loadingExperience.metrics.(key). distributions[]
    list
    loadingExperience.metrics.(key).distributions[]. min
    integer
    loadingExperience.metrics.(key).distributions[]. max
    integer
    loadingExperience.metrics.(key).distributions[]. proportion
    double
    version
    object
    The version of PageSpeed used to generate these results.
    version. major
    integer
    The major version number of PageSpeed used to generate these results.
    version. minor
    integer
    The minor version number of PageSpeed used to generate these results.
    loadingExperience.metrics.(key). category
    string


    Acceptable values are:
    • " AVERAGE "
    • " FAST "
    • " NONE "
    • " SLOW "
    loadingExperience. overall_category
    string


    Acceptable values are:
    • " AVERAGE "
    • " FAST "
    • " NONE "
    • " SLOW "
    loadingExperience. initial_url
    string
    loadingExperience.metrics.(key). percentile
    integer
    originLoadingExperience
    nested object
    Metrics of the aggregated page loading experience of the origin
    originLoadingExperience. id
    string
    The url, pattern or origin which the metrics are on.
    originLoadingExperience. metrics
    object
    originLoadingExperience.metrics. (key)
    object
    The type of the metric.
    originLoadingExperience.metrics.(key). percentile
    integer
    originLoadingExperience.metrics.(key). distributions[]
    list
    originLoadingExperience.metrics.(key).distributions[]. min
    integer
    originLoadingExperience.metrics.(key).distributions[]. max
    integer
    originLoadingExperience.metrics.(key).distributions[]. proportion
    double
    originLoadingExperience.metrics.(key). category
    string


    Acceptable values are:
    • " AVERAGE "
    • " FAST "
    • " NONE "
    • " SLOW "
    originLoadingExperience. overall_category
    string


    Acceptable values are:
    • " AVERAGE "
    • " FAST "
    • " NONE "
    • " SLOW "
    originLoadingExperience. initial_url
    string
    analysisUTCTimestamp
    string
    The UTC timestamp of this analysis.
    lighthouseResult
    nested object
    Lighthouse response for the audit url as an object.
    lighthouseResult. requestedUrl
    string
    The original requested url.
    lighthouseResult. finalUrl
    string
    The final resolved url that was audited.
    lighthouseResult. lighthouseVersion
    string
    The lighthouse version that was used to generate this LHR.
    lighthouseResult. userAgent
    string
    The user agent that was used to run this LHR.
    lighthouseResult. fetchTime
    string
    The time that this run was fetched.
    lighthouseResult. environment
    object
    Environment settings that were used when making this LHR.
    lighthouseResult.environment. networkUserAgent
    string
    lighthouseResult.environment. hostUserAgent
    string
    lighthouseResult.environment. benchmarkIndex
    double
    lighthouseResult. runWarnings[]
    list
    List of all run warnings in the LHR. Will always output to at least `[]`.
    lighthouseResult. configSettings
    object
    The configuration settings for this LHR.
    lighthouseResult.configSettings. emulatedFormFactor
    string
    The form factor the emulation should use

    Acceptable values are:
    • " UNKNOWN_FORM_FACTOR "
    • " desktop "
    • " mobile "
    • " none "
    lighthouseResult.configSettings. locale
    string
    The locale setting
    lighthouseResult.configSettings. onlyCategories
    nested object
    lighthouseResult. audits
    object
    Map of audits in the LHR.
    lighthouseResult.audits. (key)
    nested object
    lighthouseResult.audits.(key). id
    string
    The audit's id.
    lighthouseResult.audits.(key). title
    string
    The human readable title.
    lighthouseResult.audits.(key). description
    string
    The description of the audit.
    lighthouseResult.audits.(key). score
    nested object
    lighthouseResult.audits.(key). scoreDisplayMode
    string
    The enumerated score display mode.

    Acceptable values are:
    • " SCORE_DISPLAY_MODE_UNSPECIFIED "
    • " binary "
    • " error "
    • " informative "
    • " manual "
    • " not_applicable "
    • " numeric "
    lighthouseResult.audits.(key). displayValue
    string
    The value that should be displayed on the UI for this audit.
    lighthouseResult.audits.(key). explanation
    string
    An explanation of the errors in the audit.
    lighthouseResult.audits.(key). errorMessage
    string
    An error message from a thrown error inside the audit.
    lighthouseResult.audits.(key). warnings
    nested object
    lighthouseResult.audits.(key). details
    object
    Freeform details section of the audit.
    lighthouseResult.audits.(key).details. (key)
    any value
    lighthouseResult. categories
    object
    Map of categories in the LHR.
    lighthouseResult.categories. (key)
    nested object
    lighthouseResult.categories.(key). id
    string
    The string identifier of the category.
    lighthouseResult.categories.(key). title
    string
    The human-friendly name of the category
    lighthouseResult.categories.(key). description
    string
    A more detailed description of the category and its importance.
    lighthouseResult.categories.(key). score
    nested object
    lighthouseResult.categories.(key). manualDescription
    string
    A description for the manual audits in the category.
    lighthouseResult.categories.(key). auditRefs[]
    list
    An array of references to all the audit members of this category.
    lighthouseResult.categories.(key).auditRefs[]. id
    string
    The audit ref id.
    lighthouseResult.categories.(key).auditRefs[]. weight
    double
    The weight this audit's score has on the overall category score.
    lighthouseResult.categories.(key).auditRefs[]. group
    string
    The category group that the audit belongs to (optional).
    lighthouseResult. categoryGroups
    object
    Map of category groups in the LHR.
    lighthouseResult.categoryGroups. (key)
    object
    lighthouseResult.categoryGroups.(key). title
    string
    lighthouseResult.categoryGroups.(key). description
    string
    lighthouseResult. runtimeError
    object
    Object containing the code + message of any thrown runtime errors.
    lighthouseResult.runtimeError. code
    string


    Acceptable values are:
    • " ERRORED_DOCUMENT_REQUEST "
    • " FAILED_DOCUMENT_REQUEST "
    • " INSECURE_DOCUMENT_REQUEST "
    • " INVALID_SPEEDLINE "
    • " NO_DCL "
    • " NO_DOCUMENT_REQUEST "
    • " NO_ERROR "
    • " NO_FCP "
    • " NO_NAVSTART "
    • " NO_SCREENSHOTS "
    • " NO_SPEEDLINE_FRAMES "
    • " NO_TRACING_STARTED "
    • " PARSING_PROBLEM "
    • " PROTOCOL_TIMEOUT "
    • " READ_FAILED "
    • " SPEEDINDEX_OF_ZERO "
    • " TRACING_ALREADY_STARTED "
    • " UNKNOWN_ERROR "
    lighthouseResult.runtimeError. message
    string
    lighthouseResult. timing
    object
    Timing information for this LHR.
    lighthouseResult.timing. total
    double
    The total duration of Lighthouse's run
    lighthouseResult. i18n
    object
    The internationalization strings that are required to render the LHR.
    lighthouseResult.i18n. rendererFormattedStrings
    object
    lighthouseResult.i18n.rendererFormattedStrings. varianceDisclaimer
    string
    lighthouseResult.i18n.rendererFormattedStrings. opportunityResourceColumnLabel
    string
    lighthouseResult.i18n.rendererFormattedStrings. opportunitySavingsColumnLabel
    string
    lighthouseResult.i18n.rendererFormattedStrings. errorMissingAuditInfo
    string
    lighthouseResult.i18n.rendererFormattedStrings. errorLabel
    string
    lighthouseResult.i18n.rendererFormattedStrings. warningHeader
    string
    lighthouseResult.i18n.rendererFormattedStrings. auditGroupExpandTooltip
    string
    lighthouseResult.i18n.rendererFormattedStrings. passedAuditsGroupTitle
    string
    lighthouseResult.i18n.rendererFormattedStrings. notApplicableAuditsGroupTitle
    string
    lighthouseResult.i18n.rendererFormattedStrings. manualAuditsGroupTitle
    string
    lighthouseResult.i18n.rendererFormattedStrings. toplevelWarningsMessage
    string
    lighthouseResult.i18n.rendererFormattedStrings. scorescaleLabel
    string
    lighthouseResult.i18n.rendererFormattedStrings. crcLongestDurationLabel
    string
    lighthouseResult.i18n.rendererFormattedStrings. crcInitialNavigation
    string
    lighthouseResult.i18n.rendererFormattedStrings. lsPerformanceCategoryDescription
    string
    lighthouseResult.i18n.rendererFormattedStrings. labDataTitle
    string

    Try it!

    Use the APIs Explorer below to call this method on live data and see the response.
    Design a Mobile Site
    View Site in Mobile | Classic
    Share by: