# Gracenote OnConnect Lookup APIs

**Canonical:** https://apis.io/apis/gracenote/onconnect-lookup-apis/  
**Provider:** Gracenote — https://apis.io/providers/gracenote/  
**Base URL:** https://data.tmsapi.com/v1.1  
**Documentation:** https://devportal.gracenote.com/catalog/onconnect

Gracenote OnConnect Lookup APIs 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 Celebrities, Content Discovery, Electronic Program Guide, Movies, and Sports. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and API documentation.

The current published definition of the OnConnect lookup family — 40 operations across programs, series, movies on TV and in theatres, celebrities, sports, stations and lineups. This is the request-response counterpart to the ingestion-oriented On API, and the surface behind most TV guide, search and discovery experiences built on Gracenote data.

## Operations (40)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1.1/movies/showings` | Movies Playing in Local Theatres |
| GET | `/v1.1/programs/newShowAirings` | New Shows Airing on TV |
| GET | `/v1.1/sports/{sportsId}/events/airings` | Airings of Sports Events |
| GET | `/v1.1/movies/airings` | All Movies Airing on TV |
| GET | `/v1.1/lineups` | Find Lineups |
| GET | `/v1.1/lineups/{lineupId}` | Lineup Details |
| GET | `/v1.1/lineups/{lineupId}/channels` | Lineup Channel List |
| GET | `/v1.1/lineups/{lineupId}/grid` | Lineup Airings (TV Grid) |
| GET | `/v1.1/stations/search` | Station Search |
| GET | `/v1.1/stations/{stationId}` | Station Details |
| GET | `/v1.1/stations/{stationId}/airings` | Station Airings |
| GET | `/v1.1/programs/search` | Program Search |
| GET | `/v1.1/programs/{tmsId}` | Program Details |
| GET | `/v1.1/programs/{tmsId}/airings` | Program Airings |
| GET | `/v1.1/programs/newShowsLastWeek` | New Shows that Aired in Last Week |
| GET | `/v1.1/programs/advancePlanner` | Advance Planner |
| GET | `/v1.1/programs/{resourceId}/images` | All Program Images |
| GET | `/v1.1/programs/genres` | Program Genres |
| GET | `/v1.1/series/{seriesId}` | Series Details |
| GET | `/v1.1/series/{seriesId}/airings` | Series Airings |
| GET | `/v1.1/series/{seriesId}/episodes` | Series Episodes |
| GET | `/v1.1/movies/{rootId}/versions` | Movie Versions |
| GET | `/v1.1/movies/{rootId}/airings` | Movie Airings |
| GET | `/v1.1/theatres` | Find Theatres |
| GET | `/v1.1/theatres/{theatreId}` | Theatre Details |
| GET | `/v1.1/theatres/{theatreId}/showings` | Theatre Showtimes |
| GET | `/v1.1/movies/{movieId}/showings` | Movie Showtimes (single movie) |
| GET | `/v1.1/movies/futureReleases` | Future Releases |
| GET | `/v1.1/sports/{sportsId}` | Sports with Optional Organizations |
| GET | `/v1.1/sports/{sportsId}/non-events/airings` | Airings of Sports Non-Events |
| GET | `/v1.1/sports/universities` | All Universities |
| GET | `/v1.1/sports/organizations/{organizationId}` | Teams in an Organization |
| GET | `/v1.1/sports/universities/{universityId}` | Teams at a University |
| GET | `/v1.1/sports/teams/{teamBrandId}` | Team Details |
| GET | `/v1.1/sports/teams/{teamBrandId}/airings` | Team Airings |
| GET | `/v1.1/sports/organizations/{organizationId}/airings` | Organization Airings |
| GET | `/v1.1/celebs/{personId}` | Celebrity Details |
| GET | `/v1.1/celebs/{personId}/airings` | Airings of Celebrities |
| GET | `/v1.1/celebs/talkShowAirings` | Celebrities Appearing on Talk Shows by Day |
| GET | `/v1.1/celebs/{personId}/images` | All Celebrity Images |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/openapi/gracenote-onconnect-lookup-apis-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/overlays/gracenote-onconnect-lookup-apis-overlay.yaml
- **APIReference** — https://devportal.gracenote.com/catalog/onconnect
- **Documentation** — https://devportal.gracenote.com/video/on-connect-lookup-apis/index
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/gracenote/refs/heads/main/skills/gracenote-tv-listings-with-onconnect.md

## 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 On API](https://apis.io/apis/gracenote/on-api/)
- [Gracenote GVD API](https://apis.io/apis/gracenote/gvd-api/)
- [Gracenote GN IDS API](https://apis.io/apis/gracenote/gn-ids-api/)

## Tags

Celebrities, Content Discovery, Electronic Program Guide, Movies, Sports, Television

---

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