# Gracenote On API

**Canonical:** https://apis.io/apis/gracenote/on-api/  
**Provider:** Gracenote — https://apis.io/providers/gracenote/  
**Base URL:** https://on-api.gracenote.com  
**Documentation:** https://devportal.gracenote.com/video/on-api/about-the-on-api

Gracenote On API is one of 21 APIs that [Gracenote](https://apis.io/providers/gracenote/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Electronic Program Guide, Ingestion, Schedules, Sports, and Television. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, API documentation, and a changelog.

The On API is Gracenote's database-ingestion surface for television schedule data and related information — programs, schedules, celebrities, lineups, sources, sports events, teams, venues, video popularity and the controlled vocabulary behind them. It is built for platforms that pull updates on demand into their own store rather than querying per user request, and Gracenote recommends a maximum page limit of 1000 across all endpoints.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v3/Celebrities` | Celebrities |
| GET | `/v3/ControlledVocabulary` | ControlledVocabulary |
| GET | `/v3/Lineups` | Lineups |
| GET | `/v3/Programs` | Programs |
| GET | `/v3/ProgramAnnotations` | ProgramAnnotations |
| GET | `/v3/ProgramAvailabilities` | ProgramAvailabilities |
| GET | `/v3/ProgramMappings` | ProgramMappings |
| GET | `/v3/Schedules` | Schedules |
| GET | `/v3/Sources` | Sources |
| GET | `/v3/VideoDescriptorsTaxonomy` | Video Descriptors Taxonomy |
| GET | `/v3/VideoPopularity` | Video Popularity |
| GET | `/v3/Organizations` | Organizations |
| GET | `/v3/Teams` | Teams |
| GET | `/v3/Universities` | Universities |
| GET | `/v3/Venues` | Venues |
| GET | `/v3/Source/Programs` | SourcePrograms |
| GET | `/v3/Sports` | Sports |
| GET | `/v3/SportsEvents` | SportsEvents |
| GET | `/v3/SportsSchedules` | SportsSchedules |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/openapi/gracenote-on-api-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/overlays/gracenote-on-api-overlay.yaml
- **APIReference** — https://devportal.gracenote.com/catalog/on-api
- **Documentation** — https://devportal.gracenote.com/video/on-api/about-the-on-api
- **ChangeLog** — https://devportal.gracenote.com/video/on-api/release-notes

## Other Gracenote APIs (12)

- [Gracenote OnConnect API](https://apis.io/apis/gracenote/onconnect-api/)
- [Gracenote OnConnect Data API](https://apis.io/apis/gracenote/onconnect-data-api/)
- [Gracenote Celebrities API](https://apis.io/apis/gracenote/gracenote-celebrities-api/)
- [Gracenote Lineups API](https://apis.io/apis/gracenote/gracenote-lineups-api/)
- [Gracenote Movies API](https://apis.io/apis/gracenote/gracenote-movies-api/)
- [Gracenote Programs API](https://apis.io/apis/gracenote/gracenote-programs-api/)
- [Gracenote Series API](https://apis.io/apis/gracenote/gracenote-series-api/)
- [Gracenote Sports API](https://apis.io/apis/gracenote/gracenote-sports-api/)
- [Gracenote Stations API](https://apis.io/apis/gracenote/gracenote-stations-api/)
- [Gracenote OnConnect Lookup APIs](https://apis.io/apis/gracenote/onconnect-lookup-apis/)
- [Gracenote GVD API](https://apis.io/apis/gracenote/gvd-api/)
- [Gracenote GN IDS API](https://apis.io/apis/gracenote/gn-ids-api/)

## Tags

Electronic Program Guide, Ingestion, Schedules, Sports, Television, Video Metadata

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gracenote/on-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gracenote/.