HBO Max API

Overview

This API allows users to pull a random show or movie from HBO Max US. You can filter by genre, year, or media type (tv or movie). glossary.md is a glossary containing every title.

Base URL

https://api.msmc.cc/api

Endpoints

1. Pull any random title

Info

Endpoint: /hbomax/random
Method: GET

Example Request

https://api.msmc.cc/api/hbomax/random

Example Response

{
  "title": "Spring Awakening: Those You've Known",
  "type": "movie",
  "genres": "Documentary, Musical",
  "releaseYear": "2022",
  "imdbId": "tt19393916",
  "imdbAverageRating": "7.9",
  "imdbNumVotes": "751",
  "availableCountries": "AD, AG, AR, BA, BB, BG, BO, BR, BS, BZ, CL, CO, CR, CZ, DK, DO, EC, ES, FI, GT, GY, HN, HR, HU, JM, LC, MD, ME, MK, MX, NI, NL, NO, PA, PE, PL, PT, PY, RO, RS, SE, SI, SK, SV, TC, TT, US, UY, VE"
}

2. Pull any random title by genre

Info

Endpoint: /hbomax/random/:genre
Method: GET

Parameters

1. :genre - the genre you want to pull from

Example Request

https://api.msmc.cc/api/hbomax/random/documentary

Example Response

{
  "title": "The Insurrectionist Next Door",
  "type": "movie",
  "genres": "Documentary",
  "releaseYear": "2023",
  "imdbId": "tt29466126",
  "imdbAverageRating": "6.3",
  "imdbNumVotes": "849",
  "availableCountries": "AD, AG, AR, BA, BB, BG, BO, BR, BS, BZ, CL, CO, CR, CZ, DK, DO, EC, ES, FI, GT, GY, HN, HR, HU, JM, LC, MD, ME, MK, MX, NI, NL, NO, PA, PE, PL, PT, PY, RO, RS, SE, SI, SK, SV, TC, TT, US, UY, VE"
}

3. Pull any random title by year

Info

Endpoint: /hbomax/random/year/:year
Method: GET

Parameters

1. :year - the year you want to pull from

Example Request

https://api.msmc.cc/api/hbomax/random/year/2002

Example Response

{
  "title": "The Gathering Storm",
  "type": "movie",
  "genres": "Biography, Drama, History",
  "releaseYear": "2002",
  "imdbId": "tt0314097",
  "imdbAverageRating": "7.4",
  "imdbNumVotes": "7264",
  "availableCountries": "AD, AG, AR, BA, BB, BE, BG, BO, BR, BS, BZ, CL, CO, CR, CZ, DK, DO, EC, ES, FI, GT, GY, HN, HR, HU, JM, LC, MD, ME, MK, MX, NI, NL, NO, PA, PE, PL, PT, PY, RO, RS, SE, SI, SK, SV, TC, TT, US, UY, VE"
}

4. Pull any random title by type

Info

Endpoint: /hbomax/random/type/:type Method:GET``

Parameters

1. :type - the type you want to pull from (tv or movie)

Example Request

https://api.msmc.cc/api/hbomax/random/type/tv

Example Response

{
  "title": "Teen Titans",
  "type": "tv",
  "genres": "Action, Adventure, Animation",
  "releaseYear": "2003",
  "imdbId": "tt0343314",
  "imdbAverageRating": "7.9",
  "imdbNumVotes": "39407",
  "availableCountries": "AG, AR, BB, BO, BR, BS, BZ, CL, CO, CR, DO, EC, GT, GY, HN, JM, LC, MX, NI, PA, PE, PY, SV, TC, TT, US, UY, VE"
}

Response Structure

{
  "title": "",
  "type": "",
  "genres": "",
  "releaseYear": "",
  "imdbId": "",
  "imdbAverageRating": "",
  "imdbNumVotes": "",
  "availableCountries": ""
}

Support

For support, email [email protected]