State of Web Vitals

{'type': 'object', 'required': ['metric'], 'properties': {'filter': {'type': 'object', 'properties': {'cdn': {'type': 'string', 'description': 'Only sites on this CDN key (cloudflare, origin, …).'}, 'cms': {'type': 'string', 'description': 'Only sites on this CMS key (wordpress, shopify, wix, …).'}, 'device': {'enum': ['all', 'phone', 'desktop'], 'type': 'string', 'description': 'CrUX device slice. Default: all.'}, 'provider': {'type': 'string', 'description': 'Only sites that load this third-party provider key (google_analytics_4, …).'}, 'framework': {'type': 'string', 'description': 'Only sites that include this JS framework key (react, vue, jquery, …).'}}, 'description': 'AND filters. Omit for all sites in the dataset. Keys: device (all|phone|desktop), cms, framework, cdn, provider (key), provider_category (e.g. analytics — use with provider or alone is not enough; prefer group_by for rankings).', 'additionalProperties': False}, 'metric': {'type': 'string', 'description': 'lcp | inp | cls | fcp | ttfb, or a contract scalar path.'}}}

{'type': 'object', 'properties': {'focus': {'enum': ['lcp', 'inp', 'cls', 'fcp', 'ttfb'], 'type': 'string', 'description': 'CWV used when correlating technique metrics. Default: lcp.'}, 'limit': {'type': 'integer', 'description': 'Max groups or top categories. Default: 25, max: 100.'}, 'filter': {'type': 'object', 'properties': {'cdn': {'type': 'string', 'description': 'Only sites on this CDN key (cloudflare, origin, …).'}, 'cms': {'type': 'string', 'description': 'Only sites on this CMS key (wordpress, shopify, wix, …).'}, 'device': {'enum': ['all', 'phone', 'desktop'], 'type': 'string', 'description': 'CrUX device slice. Default: all.'}, 'provider': {'type': 'string', 'description': 'Only sites that load this third-party provider key (google_analytics_4, …).'}, 'framework': {'type': 'string', 'description': 'Only sites that include this JS framework key (react, vue, jquery, …).'}}, 'description': 'AND filters. Omit for all sites in the dataset. Keys: device (all|phone|desktop), cms, framework, cdn, provider (key), provider_category (e.g. analytics — use with provider or alone is not enough; prefer group_by for rankings).', 'additionalProperties': False}, 'metrics': {'description': 'Metrics to return. Default: lcp,inp,cls,ttfb,good_all3. String (comma-separated) or array of strings.'}, 'group_by': {'type': 'string', 'description': 'Break results down by this dimension: cms, frameworks, cdn, or a provider category (analytics, tag_managers, …). Omit for a single aggregate.'}, 'min_sites': {'type': 'integer', 'description': 'When group_by is set, drop groups with fewer sites. Default: 50.'}}}

{'type': 'object', 'properties': {'kind': {'type': 'string', 'description': 'Optional contract kind: scalar, boolean, categorical, set, weighted_set, measures.'}, 'include_paths': {'type': 'boolean', 'description': 'Include full contract path list. Default true.'}}}