nss_scores
Get National Student Survey positivity scores for a university provider, including OfS benchmark and UK sector average comparisons. Filter by subject, question, and study mode.
Instructions
National Student Survey results for one provider.
Returns positivity scores (the % of students answering positively) per
question and theme, with two comparators: the OfS benchmark (the score a
provider with this mix of students and subjects would be expected to get,
including whether the provider is materially above or below it) and the
UK sector average on the same cut. A score without its benchmark is
misleading; always quote both.
Args:
ukprn: Provider id from search_providers.
subject: Optional CAH subject name filter, e.g. "Law", "Nursing"
(matches partially). Omit for provider-level results.
question: Optional filter on question/theme text, e.g. "feedback",
"Theme 3", "Q14". Omit for everything.
subject_level: Granularity of the subject cut when `subject` is given:
"CAH1" (broadest, ~23 groups), "CAH2" (default, ~35 groups) or
"CAH3" (finest, ~100+). Without this the same subject would appear
once per level.
population: "Registered" (default; the OfS headline convention) or
"Taught".
mode_of_study: "All modes" (default), "Full-time", "Part-time" or
"Apprenticeship".
level_of_study: "First degree" (default), "Other undergraduate",
"Undergraduate with postgraduate component" or
"All undergraduates".
This is survey data about the student experience. It cannot tell you
application volumes, offer rates, entry requirements or fees — none of
that is in the NSS. Say so rather than inferring it from satisfaction.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ukprn | Yes | ||
| subject | No | ||
| question | No | ||
| population | No | Registered | |
| mode_of_study | No | All modes | |
| subject_level | No | CAH2 | |
| level_of_study | No | First degree |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |