Satisfaction
The stars customers left, day by day: sums and counts rather than averages, so you can average whole weeks yourself.
GET
/analytics/satisfactionAuthorization
AuthorizationBearer token · headerrequired`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.
Query parameters
fromintegerThe window's start, unix ms. Defaults to `days` ago.
daysintegerDaily buckets after `from`. Default 30.
Allowed:
73090Responses
200The window, bucketed by day.
perDaySuminteger[]perDayCountinteger[]averagenumber | nullcountintegerdistributioninteger[]How many left one star, two, and so on. Five entries.
cappedbooleanThe range held more than 2,000 ratings, so the newest 2,000 were counted.
400The request is malformed, and the message names the field.
errorobjectShow propertiesHide properties
codestringmessagestring401The bearer token is missing, revoked, or expired.
errorobjectShow propertiesHide properties
codestringmessagestring429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).
errorobjectShow propertiesHide properties
codestringmessagestringRequest
curl -X GET "https://api.median.sh/v1/analytics/satisfaction" \
-H "Authorization: Bearer YOUR_TOKEN"const response = await fetch("https://api.median.sh/v1/analytics/satisfaction", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});Response
{
"perDaySum": [
0
],
"perDayCount": [
0
],
"average": 0,
"count": 0,
"distribution": [
0
],
"capped": true
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}