---
title: "Get Web Vitals visitor context breakdown REST API | HitKeep"
description: "Reference for the HitKeep REST API operation Get Web Vitals visitor context breakdown, including request parameters, responses, and authentication notes."
canonical: "https://hitkeep.com/api/operations/apisitesidweb-vitalsbreakdown/"
---

# Get Web Vitals visitor context breakdown REST API

GET

/api/sites/{id}/web-vitals/breakdown

FetchcURL

```
const url = 'http://127.0.0.1:25737/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/web-vitals/breakdown?rating=good&metric=LCP&dimension=browser';
const options = {method: 'GET', headers: {cookie: 'hk_token=<hk_token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```
curl --request GET \
  --url 'http://127.0.0.1:25737/api/sites/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/web-vitals/breakdown?rating=good&metric=LCP&dimension=browser' \
  --cookie hk_token=<hk_token>
```

-

Returns Web Vitals p75 and rating counts for one metric grouped by browser, country, language, device, city, provider, or ASN using the matching pageview context.

## Authorizations

- **[cookieAuth](https://hitkeep.com/api/#cookieauth)**
- **[bearerAuth](https://hitkeep.com/api/#bearerauth)**
- **[apiKeyAuth](https://hitkeep.com/api/#apikeyauth)**

## Parameters

### Path Parameters

**id**

required

string format: uuid

### Query Parameters

**from**

string format: date-time

**to**

string format: date-time

**path**

string

Exact normalized page path.

**rating**

string

Allowed values: good needs_improvement poor

Web Vital threshold rating.

**metric**

required

string

Allowed values: LCP INP CLS FCP TTFB

Web Vital metric.

**dimension**

required

string

Allowed values: browser country language device city provider asn

Visitor context dimension.

**limit**

integer

>= 1 <= 100

## Responses

### 200

Web Vitals breakdown

application/json

Array<object>

object

**good**

integer

**name**

string

**needs_improvement**

integer

**p75**

number

**poor**

integer

**rating**

string

Allowed values: good needs_improvement poor

**samples**

integer

##### Example

```
[
  {
    "rating": "good"
  }
]
```

[Previous Transfer site to another team](https://hitkeep.com/api/operations/apisitesidtransfer-team/)[Next Get Web Vitals page breakdown](https://hitkeep.com/api/operations/apisitesidweb-vitalspages/)