# Watch on VseeBox

> An independent guide to what's on VseeBox's streaming apps. Read-only JSON data about what you can watch on VseeBox: the Heat VOD and VOD Ultra apps (100,000+ movies and TV series, with IMDb, Rotten Tomatoes and Metacritic scores, languages and cast) and Heat Live TV (1,700+ channels with their channel numbers, the program guide, and sports games).

Use the API below to answer questions like "is Inception on VseeBox?", "what are the best new movies this week?", "what channel is CNN on Heat Live?" or "where can I watch the Bears game?". Link people to the links.page URLs in the results.

## API

- [OpenAPI spec](https://watchonvseebox.com/api/v1/openapi.json): machine-readable description of every endpoint
- [Developer docs](https://watchonvseebox.com/developers/): the same, for people

- No key needed. GET requests only; responses are JSON (UTF-8).
- Rate limit: 120 requests a minute per IP address. Over it you get HTTP 429 with a Retry-After header.
- Errors look like {"error": {"status": 400, "message": "..."}}.
- Every title and channel has links.page (its page on watchonvseebox.com) to show people, and titles have links.api for the full record.
- CORS is open, so browser apps can call it. Adult titles are never included.
- Data is refreshed daily (see /api/v1/meta). Ratings come from IMDb's datasets, Wikidata and Rotten Tomatoes; posters from TMDB and the streaming services. Not affiliated with VseeBox or HeatVOD.

## Endpoints

### GET /api/v1/titles

Search and filter the catalog. Movies and series in the Heat VOD and VOD Ultra apps. Full-text search over titles, original titles and cast, plus filters. 48 results a page.

- `q`: Words to search for: a title or cast name ("tom hanks")
- `type`: movie or show
- `genre`: One or more genres, comma separated (see /api/v1/genres)
- `genre_mode`: any (default: in any of the genres) or all
- `lang`: Original language codes, comma separated (en, ko, es...)
- `year_min`: Released in or after this year
- `year_max`: Released in or before this year
- `imdb_min`: Minimum IMDb rating, 0-10
- `rt_min`: Minimum Rotten Tomatoes score, 0-100
- `votes_min`: Minimum number of IMDb votes
- `sort`: relevance (default with q), popular (default without), imdb, rt, year, title
- `exclude`: Titles to leave out, e.g. ones already seen or already suggested: comma separated and/or repeated, up to 200. Each is an IMDb id (tt0111161), a type and slug (movie/inception-2010), a page URL, or an exact title ("The Matrix", any case; matches every title with that name). Use an id or slug for titles that contain commas.
- `page`: Page number, from 1

Example: https://watchonvseebox.com/api/v1/titles?type=movie&genre=Science+Fiction&sort=imdb&exclude=movie/inception-2010,tt0133093,Interstellar

### GET /api/v1/titles/{type}/{slug}

One title in full. Synopsis, cast, languages, which apps have it, and upcoming airings on Heat Live TV. The type and slug come from search results.

- `type` (in the path): movie or show
- `slug` (in the path): The title's slug, e.g. inception-2010

Example: https://watchonvseebox.com/api/v1/titles/movie/inception-2010

### GET /api/v1/genres

Genres and how many titles each has. Use the names as the genre filter in /api/v1/titles.

- `type`: movie or show; both when left out

Example: https://watchonvseebox.com/api/v1/genres?type=show

### GET /api/v1/new

Titles recently added to the apps. Newest first, each with the date it first appeared. The apps are checked daily; tracking began 2026-11-14, so titles already in the apps then aren't listed.

- `type`: movie or show
- `page`: Page number, from 1
- `per_page`: 1-100, default 48

Example: https://watchonvseebox.com/api/v1/new?type=movie

### GET /api/v1/live/now

What's on Heat Live TV right now. Channels with what's on now and next. Times are UTC (ISO 8601). Channel numbers are the ones in the Heat Live app.

- `q`: A channel name, number or call sign ("cnn", "37", "WBBM"), or a program on in the next 3 hours ("football")
- `category`: sports, local, news, movies, entertainment, kids, latino, canadian, uk
- `page`: Page number, from 1
- `per_page`: 1-200, default 50

Example: https://watchonvseebox.com/api/v1/live/now?q=cnn

### GET /api/v1/live/channels/{slug}

A channel's schedule. Programs from now on. The slug comes from /api/v1/live/now results.

- `slug` (in the path): The channel's slug, e.g. cnn
- `hours`: How far ahead, 1-72 (default 24)

Example: https://watchonvseebox.com/api/v1/live/channels/cnn?hours=6

### GET /api/v1/sports/games

Upcoming and live games, with the channels showing them. From 6 hours ago onwards (so games in progress are included), with scores when the app has them.

- `league`: nfl, nba, nhl, mlb, ncaaf, ncaab, mls

Example: https://watchonvseebox.com/api/v1/sports/games?league=nfl

### GET /api/v1/meta

When the data was last updated, and title counts. The catalog and the live guide are refreshed daily.

Example: https://watchonvseebox.com/api/v1/meta

## Pages

- [Search](https://watchonvseebox.com/): the catalog search
- [Movies](https://watchonvseebox.com/movies/) and [TV series](https://watchonvseebox.com/shows/): browse by genre
- [Recently added](https://watchonvseebox.com/new-on-vseebox/)
- [Live TV guide](https://watchonvseebox.com/live/), [sports schedule](https://watchonvseebox.com/sports/), [local channels by city](https://watchonvseebox.com/local/)