HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Query Social Values

🚧

This endpoint is in beta and subject to change.

A beta revision header (2026-10-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Point-in-time aggregate statistics, optionally broken down by dimension.

Omit dimension for a single account-level row, or set it to content, creator, or auto_reply for one row per item. The revenue statistics (social_revenue, auto_reply_revenue, engagement_revenue) can't be combined with a dimension. An invalid statistic / dimension combination returns 422 with code invalid_statistic; a combination that is not yet available returns 422 with code statistic_not_yet_available.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
social:read

OpenAPI Spec

Query Params
fields[social-values-report]
array of strings
fields[social-values-report]
Allowed:
Body Params

Request body for the social-values-report endpoint.

data
object
required
Headers
string
required
Defaults to 2026-10-15.pre

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/vnd.api+json