Universities Endpoint

The Universities endpoint provides school and collegiate metadata and imagery for use with sports teams.

API and Example Responses

API:

http://on-api.gracenote.com/v3/Universities

?updateId=[updateId value]
&limit=[limit value]
&api_key=[your-api-key]

Return full list of universities:

http://on-api.gracenote.com/v3/University?api_key=<your-api-key>

Parameter	Required?	Description
api_key	Yes	24-character key obtained during application registration
updateId	No	Update token. Defaults to 0. Returns teams beginning with `updateId`, which is sequential numeric offset received in response.
limit	No	Batch size. Maximum number of universities to be returned by API. Use with `updateId`.
universityId	No	For non-batch lookups. Comma-separated list of universityIDs. If not specified, all universities are included in response.

Important: Use lookup calls for QA and troubleshooting purposes only. Gracenote does not support lookup APIs for Client production environments.

Return full list of universities:

http://on-api.gracenote.com/v3/University?api_key=<your-api-key>

Below is an example response.

Response	Description
id	numeric id used to specify university
name	university name
lastUpdDate	last datetime university data modified
assets	list of university logos, if available. Can be used as team logos for university's teams
universityGId	(Optional) will be added to uniquely identify university records.
names element	(Optional) will be added to allow support for multiple names. The names element will publish a name with attributes of language and type. Each university is expected to have at least one name of lang=’en’ and type=’default’ associated with it.
address	(Optional) address of the university with city, state and country details. These details will be optional and in future every university will have an address available.

Below is an example response. Also see: Universities record XML example

Review the following XML schema definition (xsd) to learn about the data structure, fields, and types for this endpoint.

To explore the relationships among all endpoints, see the interactive schema documentation.

XML Schema URL: http://files.api.gracenote.com/xsd/on_update_universities_3.23.xsd