LinksGet Core Web Vitals metrics

Get Core Web Vitals metrics

Proxy to the Tinybird cwv_metrics pipe for the authenticated location. Returns Core Web Vitals aggregations with optional breakdown, granularity, and dimensional filters. Returns the raw Tinybird JSON envelope.

curl -X GET "https://mythic-analytics.gulp.workers.dev/client/v1/performance/cwv?location_id=example_string&date_from=example_string&date_to=example_string&metric=lcp&breakdown=example_string&granularity=hour&page_path=example_string&page_url=example_string&device_type=example_string&browser=example_string&country=USA&utm_source=example_string&utm_medium=example_string&utm_campaign=example_string&funnel_name=John%20Doe&connection_type=example_string&hostname=John%20Doe&limit=42" \
  -H "Content-Type: application/json" \
  -H "X-Location-Id: example_string" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "metric_name": "LCP",
      "metric_unit": "ms",
      "time_bucket": "2026-02-25",
      "breakdown_value": "/pricing",
      "sample_count": 7694,
      "unique_users": 4678,
      "unique_sessions": 5901,
      "p50": 1030,
      "p75": 2200,
      "p90": 4500,
      "p95": 8200,
      "p99": 45000,
      "avg_value": 2770,
      "min_value": 50,
      "max_value": 120000,
      "good_count": 6125,
      "needs_improvement_count": 953,
      "poor_count": 616,
      "good_pct": 79.6,
      "needs_improvement_pct": 12.4,
      "poor_pct": 8
    }
  ],
  "rows": 42
}
GET
/performance/cwv
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Client API key as a bearer token. Use an agency key (ak_..., read-write) or a location secret key (sk_..., read-only). Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need links:read or links:write. See Using an mcp_ key over HTTP.

Client API key as a bearer token. Use an agency key (ak_..., read-write) or a location secret key (sk_..., read-only). Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need links:read or links:write. See Using an mcp_ key over HTTP.
query
location_idstring

Target location (client) id. Required when authenticating with an agency key (ak_); alternative to the X-Location-Id header. Ignored for secret keys, which resolve their own location.

query
date_fromstring

Start of the date range (forwarded to Tinybird).

query
date_tostring

End of the date range (forwarded to Tinybird).

query
metricstring

Metric filter. One of lcp, fcp, cls, ttfb, fid, inp.

Options: lcp, fcp, cls, ttfb, fid, inp
query
breakdownstring

Breakdown dimension. One of page, page_url, device, browser, country, country_name, utm_source, utm_medium, utm_campaign, funnel, connection, hostname, os, navigation.

query
granularitystring

Time-series granularity. One of hour, day, week, month.

Options: hour, day, week, month
query
page_pathstring

Filter to one page path. Case-insensitive and trailing-slash-insensitive (/About/ matches /about).

query
page_urlstring

Filter to one page URL. Case-insensitive, trailing-slash-insensitive, and the query string and fragment are ignored on both sides — pass the URL with or without its utm_*/fbclid soup and it matches the same page.

query
utm_sourcestring

Filter by utm_source. An empty string matches clicks with no value for that UTM.

query
limitinteger

Maximum rows to return (forwarded to Tinybird).

header
X-Location-Idstring

Target location (client) id. Required when authenticating with an agency key (ak_); alternative to the location_id query parameter. Ignored for secret keys.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Client API key as a bearer token. Use an agency key (ak_..., read-write) or a location secret key (sk_..., read-only). Format: Bearer ak_... or Bearer sk_.... Scoped keys (mcp_) are accepted too and need links:read or links:write. See Using an mcp_ key over HTTP.

Query Parameters

location_idstring

Target location (client) id. Required when authenticating with an agency key (ak_); alternative to the X-Location-Id header. Ignored for secret keys, which resolve their own location.

date_fromstring

Start of the date range (forwarded to Tinybird).

date_tostring

End of the date range (forwarded to Tinybird).

metricstring

Metric filter. One of lcp, fcp, cls, ttfb, fid, inp.

Allowed values:lcpfcpclsttfbfidinp
breakdownstring

Breakdown dimension. One of page, page_url, device, browser, country, country_name, utm_source, utm_medium, utm_campaign, funnel, connection, hostname, os, navigation.

granularitystring

Time-series granularity. One of hour, day, week, month.

Allowed values:hourdayweekmonth
page_pathstring

Filter to one page path. Case-insensitive and trailing-slash-insensitive (/About/ matches /about).

page_urlstring

Filter to one page URL. Case-insensitive, trailing-slash-insensitive, and the query string and fragment are ignored on both sides — pass the URL with or without its utm_*/fbclid soup and it matches the same page.

utm_sourcestring

Filter by utm_source. An empty string matches clicks with no value for that UTM.

limitinteger

Maximum rows to return (forwarded to Tinybird).

Headers

X-Location-Idstring

Target location (client) id. Required when authenticating with an agency key (ak_); alternative to the location_id query parameter. Ignored for secret keys.

Responses

dataarray
rowsinteger

Number of rows returned.