entertainment-api

Entertainment API

API for data about movies, TV shows, books, and comics.

Completely open-source and free to use.

Built with Gin.

Requirements

You will need Go / Golang version 1.14 or higher to run this application. (Preferably 1.18 or latest). All dependencies included in go.mod file.

Endpoints

Movies

Search for movie info by title or IMDb id.

GET /movie/title/?q=2001+space+odyssey
GET /movie/?imdb=tt0120915

Response Format:

{
    "data": {
        "Title": "2001: A Space Odyssey",
        "Year": "1968",
        "Rated": "G",
        "Runtime": "149 min",
        "Genre": "Sci-Fi",
        "Director": "Stanley Kubrick",
        "Writer": "Stanley Kubrick",
        "Actors": "Keir Dullea,Gary Lockwood,William Sylvester,Daniel Richter",
        "Plot": "2001 is a story of evolution. Sometime in the distant past, someone or something nudged evolution by placing a monolith on Earth (presumably elsewhere throughout the universe as well). Evolution then enabled humankind to reach the moon's surface, where yet another monolith is found, one that signals the monolith placers that humankind has evolved that far. Now a race begins between computers (HAL) and human (Bowman) to reach the monolith placers. The winner will achieve the next step in evolution, whatever that may be.",
        "Awards": "Won 1 Oscar. 16 wins & 12 nominations total",
        "Poster": "https://m.media-amazon.com/images/M/MV5BMmNlYzRiNDctZWNhMi00MzI4LThkZTctMTUzMmZkMmFmNThmXkEyXkFqcGdeQXVyNzkwMjQ5NzM@._V1_SX300.jpg",
        "Ratings": [
            {"Source":"Internet Movie Database","Value":"8.3/10"},
            {"Source":"Rotten Tomatoes","Value":"92%"},
            {"Source":"Metacritic","Value":"84/100"}
        ],
        "Metascore": "84",
        "imdbRating": "8.3",
        "imdbID": "tt0062622",
        "DVD": "23 Oct 2007",
        "BoxOffice": "$26,617,553",
    },
    "errors": [],
}

TV Shows

Search for a TV show info by title or IMDb id.

GET /tv//title/?q=breaking+bad
GET /tv/?imdb=tt0903747

Response Format:

{
    "data": {
        "Title": "Breaking Bad",
        "Year": "2008–2013",
        "Rated": "TV-MA",
        "Runtime": "49 min",
        "Genre": "Crime, Drama, Thriller",
        "Director": "N/A",
        "Writer": "Vince Gilligan",
        "Actors": "Bryan Cranston, Aaron Paul, Anna Gunn",
        "Plot": "A high school chemistry teacher diagnosed with inoperable lung cancer turns to manufacturing and selling methamphetamine in order to secure his family's future.",
        "Awards": "Won 16 Primetime Emmys. 154 wins & 247 nominations total",
        "Poster": "https://m.media-amazon.com/images/M/MV5BZTE2YWRlMmYtOGFkYy00MjcxLWJkNmQtNTJmNTZkZjVhZGE1XkEyXkFqcGdeQXVyMTMzNDExODE5._V1_SX300.jpg",
        "Ratings": [
            {
                "Source": "Internet Movie Database",
                "Value": "9.5/10"
            },
            {
                "Source": "Rotten Tomatoes",
                "Value": "96%"
            }
        ],
        "Metascore": "N/A",
        "imdbRating": "9.5",
        "imdbID": "tt0903747",
        "DVD": "",
        "BoxOffice": "",
        "totalSeasons": "5"
    },
    "errors": []
}

Books

Search for list of books and their info by title or author.

GET /book/title/?q=dune
GET /book/author/?q=frank+herbert

Response Format:

{
    "data": {
        "totalItems": 2003,
        "items": [
            {
                "volumeInfo": {
                    "title": "Dune",
                    "authors": [
                        "Frank Herbert"
                    ],
                    "publisher": "Penguin",
                    "publishedDate": "2005",
                    "description": "Follows the adventures of Paul Atreides, the son of a betrayed duke given up for dead on a treacherous desert planet and adopted by its fierce, nomadic people, who help him unravel his most unexpected destiny.",
                    "pageCount": 528,
                    "printType": "BOOK",
                    "averageRating": 4.5,
                    "maturityRating": "NOT_MATURE",
                    "imageLinks": {
                        "smallThumbnail": "http://books.google.com/books/content?id=B1hSG45JCX4C&printsec=frontcover&img=1&zoom=5&edge=curl&source=gbs_api",
                        "thumbnail": "http://books.google.com/books/content?id=B1hSG45JCX4C&printsec=frontcover&img=1&zoom=1&edge=curl&source=gbs_api"
                    },
                    "language": "en"
                }
            },
        ]
    "errors": [],
}

Music

Search for list of songs (and what album and arist they correspond to) and their info by title, artist, or album.

GET /music/song/?q=first+class
GET /music/artist/?q=jack+harlow
GET /music/album/?q=come+home+the+kids+miss+you

{
    "data": [
        {
            "title": "First Class",
            "duration": 173,
            "rank": 100000,
            "explicit_lyrics": true,
            "preview": "https://cdns-preview-5.dzcdn.net/stream/c-501db2aa7a1201b34c0dc6cd7ed69b15-3.mp3",
            "artist": {
                "name": "Jack Harlow",
                "picture_small": "https://e-cdns-images.dzcdn.net/images/artist/7d5211931ac5ef6efe0a88e31ae5ab82/56x56-000000-80-0-0.jpg",
                "picture_medium": "https://e-cdns-images.dzcdn.net/images/artist/7d5211931ac5ef6efe0a88e31ae5ab82/250x250-000000-80-0-0.jpg",
                "picture_big": "https://e-cdns-images.dzcdn.net/images/artist/7d5211931ac5ef6efe0a88e31ae5ab82/500x500-000000-80-0-0.jpg",
                "picture_xl": "https://e-cdns-images.dzcdn.net/images/artist/7d5211931ac5ef6efe0a88e31ae5ab82/1000x1000-000000-80-0-0.jpg",
                "type": "artist"
            },
            "album": {
                "title": "First Class",
                "cover_small": "https://e-cdns-images.dzcdn.net/images/cover/8aa3f894894c7c7dfcce5df9eccababd/56x56-000000-80-0-0.jpg",
                "cover_medium": "https://e-cdns-images.dzcdn.net/images/cover/8aa3f894894c7c7dfcce5df9eccababd/250x250-000000-80-0-0.jpg",
                "cover_big": "https://e-cdns-images.dzcdn.net/images/cover/8aa3f894894c7c7dfcce5df9eccababd/500x500-000000-80-0-0.jpg",
                "cover_xl": "https://e-cdns-images.dzcdn.net/images/cover/8aa3f894894c7c7dfcce5df9eccababd/1000x1000-000000-80-0-0.jpg",
                "tracklist": "https://api.deezer.com/album/308990637/tracks",
                "type": "album"
            },
            "type": "track"
        },
    ],
}