Whats IMDBSpy?

IMDBSpy API fetchs informations about series, movies, series seasons, stars and more fastly and easily on imdb.com.

 

Whats IMDBSpy used for?

A developer who develops projects using the IMDBSpy API service can access a range of content, such as series information, seasons, episodes, players, at imdb.com. It also allows you to access media contens like poster, trailer, videos.

 

What can be done using IMDBSpy?

You can provide more content in your project using the IMDBSpy API. You can access all the details about the series and movies quickly and easily. IMDBSpy takes over the entire workload, saving developers from writing pages of code.

https://diziizle.tech/api/1.0/{proces-type}

1. Authentication

In order to use our service, you need to login and post access_token each time you request.

You can review the example below about this request.

curl https://diziizle.tech/api/1.0/{proces-type} \
                            -access_token $_ACCESS_TOKEN_$
                        

-access_token You need to post your access_token with that parameter during curl process.

2. Requests

On the left menu you can see what the IMDBSpy API offers you. For details, just click on the request name.

2.1. get_info

This request returns the information of the series or movie in which you entered the imdb ID.

Some Returns;
Content name, content description, content poster, content category, stars, producers, keywords, ratings, content country, content language, last review, trailer.

You should make a request to the following address with the access_token given to you.

Required Variables
  • access_token

    Required for authentication.

  • imdb_id or title

    If you want to query with imdb id, you should use imdb_id, if you want to query with title you should use title parameter.

Array
(
    [success] => true
    [response] => Array
        (
            [@context] => http://schema.org
            [@type] => TVSeries
            [url] => /title/tt3281796/
            [name] => Power
            [image] => https://m.media-amazon.com/images/M/[email protected]_V1_.jpg
            [genre] => Array
                (
                    [0] => Crime
                    [1] => Drama
                )

            [contentRating] => TV-MA
            [actor] => Array
                (
                    [0] => Array
                        (
                            [@type] => Person
                            [url] => /name/nm1165044/
                            [name] => Omari Hardwick
                        )

                    [1] => Array
                        (
                            [@type] => Person
                            [url] => /name/nm1166613/
                            [name] => Naturi Naughton
                        )

                    [2] => Array
                        (
                            [@type] => Person
                            [url] => /name/nm0797746/
                            [name] => Joseph Sikora
                        )

                    [3] => Array
                        (
                            [@type] => Person
                            [url] => /name/nm0426209/
                            [name] => Shane Johnson
                        )

                )

            [creator] => Array
                (
                    [0] => Array
                        (
                            [@type] => Person
                            [url] => /name/nm2194189/
                            [name] => Courtney A. Kemp
                        )

                    [1] => Array
                        (
                            [@type] => Organization
                            [url] => /company/co0274041/
                        )

                )

            [description] => Power is a TV series starring Omari Hardwick, Naturi Naughton, and Joseph Sikora. James "Ghost" St. Patrick, a wealthy New York night club owner who has it all, catering to the city's elite and dreaming big, lives a double life as a...
            [datePublished] => 2014-06-07
            [keywords] => hip hop,nightclub owner,family business,money laundering,illegal business
            [aggregateRating] => Array
                (
                    [@type] => AggregateRating
                    [ratingCount] => 30208
                    [bestRating] => 10.0
                    [worstRating] => 1.0
                    [ratingValue] => 8.2
                )

            [review] => Array
                (
                    [@type] => Review
                    [itemReviewed] => Array
                        (
                            [@type] => CreativeWork
                            [url] => /title/tt3281796/
                        )

                    [author] => Array
                        (
                            [@type] => Person
                            [name] => danidar19
                        )

                    [dateCreated] => 2018-12-29
                    [inLanguage] => English
                    [name] => Very good show
                    [reviewBody] => Season 1 is a bit slow, but with every episode it gets better and better.
                    [reviewRating] => Array
                        (
                            [@type] => Rating
                            [worstRating] => 1
                            [bestRating] => 10
                            [ratingValue] => 9
                        )

                )

            [trailer] => Array
                (
                    [@type] => VideoObject
                    [name] => TV Spot
                    [embedUrl] => /video/imdb/vi550615833
                    [thumbnail] => Array
                        (
                            [@type] => ImageObject
                            [contentUrl] => https://m.media-amazon.com/images/M/MV5BYjdiYzRkNTMtMmIyNC00YjIxLTg0NzYtMzdlMTk0NGRmY2ZmXkEyXkFqcGdeQXRzdGFzaWVr._V1_.jpg
                        )

                    [thumbnailUrl] => https://m.media-amazon.com/images/M/MV5BYjdiYzRkNTMtMmIyNC00YjIxLTg0NzYtMzdlMTk0NGRmY2ZmXkEyXkFqcGdeQXRzdGFzaWVr._V1_.jpg
                    [description] => "Power" returns to STARZ for Season 5.
                    [uploadDate] => 2018-07-09T22:16:24Z
                )

        )

)

                            

2.2. person_info

You should make a request to the following address with the access_token given to you.

Required Variables
  • access_token

    Required for authentication.

  • imdb_id

    IMDB star id

Array
(
    [@context] => http://schema.org
    [@type] => Person
    [url] => /name/nm0186505/
    [name] => Bryan Cranston
    [image] => https://m.media-amazon.com/images/M/[email protected]_V1_.jpg
    [jobTitle] => Array
        (
            [0] => Actor
            [1] => Producer
            [2] => Writer
        )

    [description] => Bryan Lee Cranston, 7 Mart 1956'da Hollywood, California'da, bir radyo yıldızı olan Audrey Peggy Sell'e, oyuncu ve eski amatör boksör Joe Cranston'a doğdu.  Anneannesinin dedesi Almandı ve babası İrlandalı, Alman ve Avusturya-Yahudi soyundandı.  Los Angeles'ın Canoga Park semtinde büyüdü ve aynı zamanda ...
    [birthDate] => 1956-03-07
    [birthCity] => Hollywood, California, USA
    [knownfor] => Array
        (
            [0] => Array
                (
                    [contentName] => Breaking Bad
                    [character] => Walter White
                    [year] => (2008-2013)
                    [img] => https://m.media-amazon.com/images/M/MV5BMjhiMzgxZTct[email protected]._V1_UY216_CR3,0,148,216_AL_.jpg
                )

            [1] => Array
                (
                    [contentName] => Malcolm mittendrin
                    [character] => Hal
                    [year] => (2000-2006)
                    [img] => https://m.media-amazon.com/images/M/MV5BNTc2MzM2N2Yt[email protected]._V1_UX148_CR0,0,148,216_AL_.jpg
                )

            [2] => Array
                (
                    [contentName] => Argo
                    [character] => Jack O'Donnell
                    [year] => (2012)
                    [img] => https://m.media-amazon.com/images/M/MV5BNzljNjY3MDYt[email protected]._V1_UX148_CR0,0,148,216_AL_.jpg
                )

            [3] => Array
                (
                    [contentName] => Trumbo
                    [character] => Dalton Trumbo
                    [year] => (2015)
                    [img] => https://m.media-amazon.com/images/M/[email protected]_V1_UX148_CR0,0,148,216_AL_.jpg
                )

        )

)
                            

2.3. get_casts

This request returns the entire cast of the series or movie in which you entered the imdb ID.

Some Returns;
Star name, played characters, star poster...

You should make a request to the following address with the access_token given to you.

Required Variables
  • access_token

    Required for authentication.

  • imdb_id

    IMDB series/movie id

Array
(
    [success] => true
    [response] => Array
        (
            [0] => Array
                (
                    [name] => Bryan Cranston
                    [characterName] => Walter White
                    [img] => https://m.media-amazon.com/images/M/[email protected]_V1_UX32_CR0,0,32,44_AL_.jpg
                    [link] => nm0186505
                )

            [1] => Array
                (
                    [name] => Anna Gunn
                    [characterName] => Skyler White
                    [img] => https://m.media-amazon.com/images/M/[email protected]@._V1_UX32_CR0,0,32,44_AL_.jpg
                    [link] => nm0348152
                )

            [2] => Array
                (
                    [name] => Aaron Paul
                    [characterName] => Jesse Pinkman
                    [img] => https://m.media-amazon.com/images/M/[email protected]@._V1_UX32_CR0,0,32,44_AL_.jpg
                    [link] => nm0666739
                )

        )
)

                            

2.4. get_episodes

This request lists the episodes of the series which you entered imdb ID.

Some Returns;
Episode name, episode summary, air date, rating...

You should make a request to the following address with the access_token given to you.

Required Variables
  • access_token

    Required for authentication.

  • imdb_id

    IMDB series/movie id

  • sezon

    Season number (int)

Array
(
    [success] => true
    [response] => Array
        (
            [1] => Array
                (
                    [id] => tt8884160
                    [episodeNumber] => 1
                    [episodeName] => A High-Pitched Buzz and Training Wheels
                    [rating] => 7.8
                    [description] => Sheldon can sıkıcı bir hüzmesi durdurmak için buzdolabını söker, daha sonra tamiratlarını ödemek için bir kağıt yol alır.
                )

        )

)

2.5. get_episode

This request returns informations about episode which you entered imdb ID.

Some Returns;
Episode name, episode summary, episode point, air date, episode photos, episode cast...

You should make a request to the following address with the access_token given to you.

Required Variables
  • access_token

    Required for authentication.

  • imdb_id

    IMDB Episode ID

Array
(
    [success] => true
    [response] => Array
        (
            [0] => https://m.media-amazon.com/images/M/MV5BOWVhZDQyNzc[email protected]@._V1_UY99_CR40,0,99,99_AL_.jpg
            [1] => https://m.media-amazon.com/images/M/MV5BZDIwYTRlMTc[email protected]@._V1_UY99_CR40,0,99,99_AL_.jpg
            [2] => https://m.media-amazon.com/images/M/MV5BZDAxZTNhZWY[email protected]@._V1_UY99_CR11,0,99,99_AL_.jpg
            [3] => https://m.media-amazon.com/images/M/MV5BNzUwMjU2MzIt[email protected]._V1_UY99_CR16,0,99,99_AL_.jpg
            [4] => https://m.media-amazon.com/images/M/MV5BODZmZTk4MGU[email protected]@._V1_UY99_CR39,0,99,99_AL_.jpg
            [5] => https://m.media-amazon.com/images/M/MV5BNmMwZmIyOGM[email protected]@._V1_UY99_CR40,0,99,99_AL_.jpg
        )

)

2.6. search

This request returns all series and movie results related to the keyword you entered.

Some Returns;
content name, content poster, content imdb id, content year...

You should make a request to the following address with the access_token given to you.

Required Variables
  • access_token

    Required for authentication.

  • keyword

    Keyword

Array
(
    [success] => true
    [response] => Array
        (
            [0] => Array
                (
                    [id] => tt0455275
                    [name] => Prison Break
                    [img] => https://m.media-amazon.com/images/M/[email protected]@.jpg
                    [year] => 2005
                )

            [1] => Array
                (
                    [id] => tt1131748
                    [name] => Prison Break: Ein letzter Schritt zur Freiheit
                    [img] => https://m.media-amazon.com/images/M/[email protected]
                    [year] => 2009
                )

            [2] => Array
                (
                    [id] => tt1531425
                    [name] => Prison Break: The Conspiracy
                    [img] => https://m.media-amazon.com/images/M/[email protected]
                    [year] => 2010
                )

        )

)

3. Errors

IMDBSpy may return you errors as a result of server-based, or incorrect usage. If you get an error, you can learn the meaning of the error and what caused it below.

Errors
406 The access token you entered is wrong.
416 The access token you entered is disabled by administrator.
426 The usage limit of your access token is up.
436 The access token you entered is not registered this domain / server ip.