# get page summary insights

POST /v3/web-audits/{auditId}/runs/{runId}/reports/page-summary

Endpoint: POST /v3/web-audits/{auditId}/runs/{runId}/reports/page-summary
Security: API_Key

## Path parameters:

  - `auditId` (integer, required)
    Unique identification number for web audit
    Example: 107239

  - `runId` (integer, required)
    Unique identification number for web audit or journey run
    Example: 33010

## Request fields (application/json):

  - `pageLoadTime` (object)
    Page load time in milliseconds. Should have  and/or  properties defined.  is inclusive and  is exclusive.  should be less than .

  - `pageLoadTime.min` (integer)

  - `pageLoadTime.max` (integer)

  - `pageUrl` (object)

  - `pageUrl.filterType` (string, required)
    Enum: "contains", "regex"

  - `pageUrl.filterValue` (string, required)

  - `pageUrl.negated` (boolean)
    Switches from "contains" to "not contains", and from "matches regex" to "does not match regex". Supported only by Page Summary for now

  - `finalPageUrl` (object)

  - `pageSize` (object)
    Page size in bytes. Should have  and/or  properties defined.  is inclusive and  is exclusive.  should be less than .

  - `primaryTagsOnly` (boolean)

  - `tagId` (integer)

  - `tagCategoryId` (integer)

  - `tagAccount` (string)

  - `tagVendorId` (integer)
    Tag vendor ID

  - `pageTitle` (object)

  - `pageTitle.filterValue` (string, required)
    Page title as displayed by browser
    Example: "ObserveP"

  - `initialPageStatusCode` (object)

  - `initialPageStatusCode.negated` (boolean, required)
    Switches from  to , and from  to

  - `finalPageStatusCode` (object)

  - `hasBrokenLinks` (boolean)

  - `redirectCount` (object)
    Number of redirects for a page. Should have  and/or  properties defined.  is inclusive and  is exclusive.  should be less than .

  - `combinedPageStatusCode` (string)
    -  - initial or final URL are ,
-  - initial URL is  or  and final URL is
    Enum: "broken", "good"

  - `hasParentPage` (boolean)
    Usage:
-  - only pages that do not have a parent page will be returned - starting URLs 
-  - only pages that have a parent page will be returned - pages that were discovered during crawling
-  or undefined - all pages will be returned.

  - `pageUrlMatchingAuditFilterConfiguration` (boolean)

  - `errors` (object)
    non-empty list of kinds of errors present on a page, depends on :
- : page has all types of errors specified in  list
- : page has any type of errors present in specified  list

  - `errors.errorTypes` (array, required)
    Enum: "ON_PAGE_ACTION_ERROR"

  - `largestContentfulPaint` (object)
    Common trait for integer min max filter

  - `firstContentfulPaint` (object)
    Common trait for integer min max filter

  - `timeToFirstByte` (object)
    Common trait for integer min max filter

  - `cumulativeLayoutShift` (object)
    Common trait for double min max filter

  - `pageStatusCode` (string)
    good - 2xx, redirects - 3xx, broken - all others
    Enum: "good", "redirects", "broken"

## Response 200 fields (application/json):

  - `pagesFiltered` (integer)

  - `totalPages` (integer)

  - `averagePageLoadTime` (integer)

  - `pagesWithBrokenInitialStatusCode` (integer)

  - `pagesWithBrokenFinalStatusCode` (integer)

  - `pageCountByLoadTimes` (object)

  - `pageCountByLoadTimes.below3` (integer)

  - `pageCountByLoadTimes.3to6` (integer)

  - `pageCountByLoadTimes.6to10` (integer)

  - `pageCountByLoadTimes.10andAbove` (integer)

  - `pageCountsByInitialStatusCodes` (object)

  - `pageCountsByInitialStatusCodes.good` (integer)

  - `pageCountsByInitialStatusCodes.redirects` (integer)

  - `pageCountsByInitialStatusCodes.broken` (integer)

  - `pageCountsByFinalStatusCodes` (object)

  - `pagesWithBrokenLinks` (integer)
    Count of all pages that have broken links pointing to other pages

  - `webVitals` (object)
    Web Vitals aggregated on run level

  - `webVitals.p75LargestContentfulPaint` (number, required)
    75th percentile LCP time in milliseconds

  - `webVitals.p75FirstContentfulPaint` (number, required)
    75th percentile FCP time in milliseconds

  - `webVitals.p75TimeToFirstByte` (number, required)
    75th percentile TTFB time in milliseconds

  - `webVitals.p75CumulativeLayoutShift` (number, required)
    75th percentile CLS, unitless measurement.

  - `webVitals.medianLargestContentfulPaint` (number, required)
    median LCP time in milliseconds. This field is deprecated and will be removed in the future. Use 75th percentile LCP time instead.

  - `webVitals.medianFirstContentfulPaint` (number, required)
    median FCP time in milliseconds. This field is deprecated and will be removed in the future. Use 75th percentile FCP time instead.

  - `webVitals.medianTimeToFirstByte` (number, required)
    median TTFB time in milliseconds. This field is deprecated and will be removed in the future. Use 75th percentile TTFB time instead.

  - `webVitals.medianCumulativeLayoutShift` (number, required)
    median unitless measurement of CLS. This field is deprecated and will be removed in the future. Use 75th percentile CLS instead.

  - `brokenPages` (integer)

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 401 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)

## Response 404 fields (application/json):

  - `timestamp` (string)

  - `message` (string)

  - `details` (string)

  - `validationReport` (object)