Catalog / Knight-Newhouse College Athletics Data

Knight-Newhouse College Athletics Data API

knightnewhousedata.org

A live, read-only API for the public Knight-Newhouse College Athletics Database. The API discovers NCAA Division I institutions from the site's FBS, FCS, and No Football pages, returns source identifiers and links, follows institution previews to canonical profiles, and parses the profile's source HTML and embedded Highcharts JSON into structured financial sections. Profile data preserves the site's labels, numeric values, years, medians, units, and unavailable values. Profile controls expose the available year selectors and inflation checkbox. The Custom Reports route exposes the site's report selectors, metric IDs, predefined groups, year universe, and inflation setting. Anonymous report generation remains source-CAPTCHA protected, so comparison figures are declared unavailable rather than guessed or synthesized.

  • Sports
  • college athletics
  • NCAA
  • finance
  • Knight-Newhouse
7 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Knight-Newhouse College Athletics Data API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Searches source institutions by subdivision, optional conference path slug, institution name, displayed region, or the State field on each canonical profile. Every returned card is expanded through the source preview so its numeric ID, canonical slug/profile URL, conference, subdivision, and public/private status are source-backed.

Optional parameters 5

Source subdivision slug.

Source conference path slug, for example big-12 or sunbelt.

Case-insensitive substring matched against the source card name.

Case-insensitive substring matched against the displayed REGION value.

Case-insensitive substring matched against each returned canonical profile's State field.

View call pricing
cURL · Schools
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/cf1a2b5b-e331-4afc-b1e3-88318daefa3a/v1/schools' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETSchools/v1/schools

Searches source institutions by subdivision, optional conference path slug, institution name, displayed region, or the State field on each canonical profile. Every returned card is expanded through the source preview so its numeric ID, canonical slug/profile URL, conference, subdivision, and public/private status are source-backed.

Input

subdivisionOptionalQuery · string, default: fbs

Source subdivision slug.

Example: fbs

conferenceOptionalQuery · string | null

Source conference path slug, for example big-12 or sunbelt.

Example: big-12

nameOptionalQuery · string | null

Case-insensitive substring matched against the source card name.

Example: Arizona State

regionOptionalQuery · string | null

Case-insensitive substring matched against the displayed REGION value.

Example: Southwest

stateOptionalQuery · string | null

Case-insensitive substring matched against each returned canonical profile's State field.

Example: Arizona

Response

itemsobject[]
items[].namestring
items[].slug?string | null
items[].state?string | null
items[].region?string | null
items[].conference?string | null
items[].source_urlstring
items[].preview_urlstring
items[].profile_url?string | null
items[].subdivision?string | null
items[].institution_idinteger
items[].institution_status?string | null
notes?string[]
totalinteger
filtersobject
conferencestring | null
source_urlstring
subdivisionstring | null

Fields marked ? are optional.

GETConferences/v1/conferences

Lists conference links exposed on a source subdivision page. Member cards preserve source preview IDs and regions; pass a conference slug and include_member_profiles=true to expand one conference's members through source previews, or use the schools route with conference for the same structured identities.

Input

subdivisionOptionalQuery · string, default: fbs

Source subdivision slug: fbs, fcs, or nfs.

Example: fbs

conferenceOptionalQuery · string | null

Optional source conference path slug; use with include_member_profiles for a complete expanded member set.

Example: sunbelt

include_member_profilesOptionalQuery · boolean, default: false

When true, expand members for the selected conference through source previews.

Example: false

Response

itemsobject[]
items[].namestring
items[].slugstring
items[].members?object[]
items[].members[].namestring
items[].members[].slug?string | null
items[].members[].state?string | null
items[].members[].region?string | null
items[].members[].conference?string | null
items[].members[].source_urlstring
items[].members[].preview_urlstring
items[].members[].profile_url?string | null
items[].members[].subdivision?string | null
items[].members[].institution_idinteger
items[].members[].institution_status?string | null
items[].source_urlstring
items[].subdivisionstring
notes?string[]
totalinteger
source_urlstring
subdivisionstring

Fields marked ? are optional.

GETSubdivisions/v1/subdivisions

Fetches the source FBS, FCS, and No Football pages and counts their institution-preview cards.

Input

No input parameters.

Response

itemsobject[]
items[].namestring
items[].slugstring
items[].source_urlstring
items[].institution_countinteger
source_urlstring
GETReport options/v1/reports/options

Fetches the public Custom Reports form and returns its source metric IDs/labels, predefined groups, institution filters, years, inflation checkbox, and CAPTCHA availability. The source's generated comparison figures are not returned because anonymous report submission is CAPTCHA protected.

Input

No input parameters.

Response

yearsstring[]
source_urlstring
form_methodstring
source_notes?string[]
metric_groupsobject[]
requires_captchaboolean
predefined_groupsobject[]
institution_filtersobject[]
inflation_adjustmentobject

Fields marked ? are optional.

GETInstitutions by institution ref/v1/institutions/{institution_ref}

Resolves a numeric source institution ID through its public preview, or accepts a source profile path/slug, then fetches and parses the canonical profile. The response includes profile fields, available years, all chart sections present in the page, conference and subdivision median series, and source controls.

Input

institution_refRequiredPath · string

Numeric source institution ID from a listing/preview, or a source profile path such as fbs/sun-belt/appalachian-state-university.

Example: 16

Response

namestring
slug?string | null
controlsobject[]
source_urlstring
source_notes?string[]
institution_id?integer | null
profile_fieldsobject
financial_yearsstring[]
financial_sectionsobject[]
financial_sections[].labelstring
financial_sections[].section_idstring
financial_sections[].description?string | null
financial_sections[].observationsobject[]
financial_sections[].observations[].valuesobject[]
financial_sections[].observations[].values[].unit?string | null
financial_sections[].observations[].values[].yearstring
financial_sections[].observations[].values[].valueinteger | number | string | null
financial_sections[].observations[].source_labelstring
financial_sections[].presentationstring

Fields marked ? are optional.

GETInstitution previews by institution id/v1/institution-previews/{institution_id}

Fetches the site's public AJAX preview and parses its embedded HTML into a structured institution record. The raw Drupal command/widget payload is not returned; use the profile and financials routes for the complete source page.

Input

institution_idRequiredPath · integer

The numeric institution ID used by the site's preview route.

Example: 16

Response

namestring
slug?string | null
state?string | null
region?string | null
conference?string | null
source_urlstring
preview_urlstring
profile_url?string | null
subdivision?string | null
institution_idinteger
institution_status?string | null

Fields marked ? are optional.

GETInstitution financials by institution ref/v1/institutions/{institution_ref}/financials

Returns source chart sections and observations for an institution. Optional year/range inputs filter the values present in the fetched page; the source page exposes 2005-2025 selectors while its default profile charts provide category breakdowns for the selected current year and time-series comparisons for available ranges. With a range and adjust_inflation=true, the source returns CPI-adjusted historical time-series values; current-year values remain unchanged. Values remain source numeric values with source chart amount units.

Input

institution_refRequiredPath · string

Numeric source institution ID or source profile path/slug.

Example: 16

yearOptionalQuery · string | null

One source year to retain when it is present in the returned chart series.

Example: 2025

year_fromOptionalQuery · string | null

Inclusive source year range start.

Example: 2020

year_toOptionalQuery · string | null

Inclusive source year range end.

Example: 2025

adjust_inflationOptionalQuery · boolean, default: false

Requests the source inflation setting. Historical time-series values are returned with CPI-adjusted units when the source changes them; unchanged current-year category values retain source chart amount units.

Example: false

Response

namestring
slug?string | null
controlsobject[]
source_urlstring
source_notes?string[]
institution_id?integer | null
profile_fieldsobject
requested_year?string | null
returned_yearsstring[]
financial_yearsstring[]
requested_year_to?string | null
financial_sectionsobject[]
financial_sections[].labelstring
financial_sections[].section_idstring
financial_sections[].description?string | null
financial_sections[].observationsobject[]
financial_sections[].observations[].valuesobject[]
financial_sections[].observations[].values[].unit?string | null
financial_sections[].observations[].values[].yearstring
financial_sections[].observations[].values[].valueinteger | number | string | null
financial_sections[].observations[].source_labelstring
financial_sections[].presentationstring
requested_year_from?string | null
requested_inflation_adjustment?boolean, default: false

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.