Git Product home page Git Product logo

metacritic-api's Introduction

metacritic-api

You can use the ff endpoints:

SEARCH

api.marcalencc.com/metacritic/search/<dash-separated-search-string>/<mediaType>
<mediaType> = album|tvshow|movie

Example

Request: http://api.marcalencc.com/metacritic/search/spider-man/movie
Response:

<snip>
[  
  {  
     "SearchItems":[  
        {  
           "Id":"/movie/spider-man-homecoming",
           "Title":"Spider-Man: Homecoming",
           "ReleaseDate":"July 7, 2017",
           "Genre":"Action, Adventure, Sci-Fi, Fantasy, Family",
           "Rating":{  
              "CriticRating":73
           }
        },
        {  
           "Id":"/movie/spider-man-2",
           "Title":"Spider-Man 2",
           "ReleaseDate":"June 30, 2004",
           "Genre":"Action, Sci-Fi, Thriller, Fantasy",
           "Rating":{  
              "CriticRating":83
           }
        },
        {  
           "Id":"/movie/the-amazing-spider-man-2",
           "Title":"The Amazing Spider-Man 2",
           "ReleaseDate":"May 2, 2014",
           "Genre":"Action, Adventure, Fantasy",
           "Rating":{  
              "CriticRating":53
           }
        },
</snip>
  • Id field can then be used for subsequent requests. (See media requests below.)

  • Limit and offset can be specified on search requests. Default and maximum limit is 20. Default offset is 0.

/search/<dash-separated-search-string>/<mediaType>?limit=15&offset=21
/search/<dash-separated-search-string>/<mediaType>?offset=15
/search/<dash-separated-search-string>/<mediaType>?limit=10

PERSON

api.marcalencc.com/metacritic/person/<name-separated-by-a-dash>/<mediaType>
<mediaType> = album|tvshow|movie

Example

Request: http://api.marcalencc.com/metacritic/person/car-seat-headrest/album
Response:

[  
   {  
      "Name":"Car Seat Headrest",
      "RatingsSummary":{  
         "HighestRating":86.0,
         "LowestRating":79.0,
         "ReviewCount":2,
         "AverageRating":82.5
      },
      "CreditMediaPairItems":[  
         {  
            "Credit":"Primary Artist",
            "Item":{  
               "Id":"/album/teens-of-denial",
               "Title":"Teens of Denial",
               "ReleaseDate":"05/20/2016",
               "Rating":{  
                  "CriticRating":86,
                  "UserRating":8.3
               }
            }
         },
         {  
            "Credit":"Primary Artist",
            "Item":{  
               "Id":"/album/teens-of-style",
               "Title":"Teens of Style",
               "ReleaseDate":"10/30/2015",
               "Rating":{  
                  "CriticRating":79,
                  "UserRating":6.9
               }
            }
         }
      ]
   }
]
  • Id field can then be used for subsequent requests. (See media requests below.)

MEDIA ITEM REQUEST

Alternatively, just plug in the dash separated title of the item being searched.

api.marcalencc.com/metacritic/<mediaType>/<title-separated-by-a-dash>
api.marcalencc.com/metacritic/<mediaType>/<title-separated-by-a-dash>/<year>
api.marcalencc.com/metacritic/<mediaType>/<title-separated-by-a-dash>/<details>
api.marcalencc.com/metacritic/<mediaType>/<title-separated-by-a-dash>/<year>/<details>

<mediaType> = album|tvshow|movie
<year> = specify the release year e.g (2015) or season for tv shows e.g. (6) to filter the results
<details> = to get the item credits instead of the item info and reviews

Note: If the name or title has a '-', prefix it with a '~' e.g (/person/jay~-z/album)

Example

Request: http://api.marcalencc.com/metacritic/tvshow/the-big-bang-theory/1
Response:

[  
   {  
      "Season":1,
      "Studio":"CBS",
      "Title":"The Big Bang Theory",
      "ReleaseDate":"09/24/2007",
      "Rating":{  
         "CriticRating":57,
         "CriticReviewCount":23,
         "UserRating":8.0,
         "UserReviewCount":1270
      },
      "ImageUrl":"http://static.metacritic.com/images/products/tv/0/16d908fb64cd4719701eb83f7c787dce-53.jpg"
   }
]

Request: http://api.marcalencc.com/metacritic/album/1989/2014
Response:

[  
   {  
      "PrimaryArtist":"Taylor Swift",
      "Title":"1989",
      "ReleaseDate":"10/27/2014",
      "Rating":{  
         "CriticRating":76,
         "CriticReviewCount":29,
         "UserRating":6.8,
         "UserReviewCount":1225
      },
      "ImageUrl":"http://static.metacritic.com/images/products/music/7/37d41a1210252e00054ab77139189533-53.jpg"
   }
]

Request: http://api.marcalencc.com/metacritic/movie/black-swan/details
Response:

<snip>
[  
   {  
      "Details":[  
         {  
            "Description":"Runtime",
            "Value":"108"
         },
         {  
            "Description":"Rating",
            "Value":"for strong sexual content, disturbing violent images, language and some drug use"
         },
         {  
            "Description":"Production",
            "Value":"Phoenix Pictures"
         },
         {  
            "Description":"Genres",
            "Value":"Drama, Thriller"
         },
         {  
            "Description":"Country",
            "Value":"USA"
         },
         {  
            "Description":"Language",
            "Value":"English"
         },
         {  
            "Description":"Home Release Date",
            "Value":"Mar 29, 2011"
         }
      ],
      "Credits":[  
         {  
            "Name":"Darren Aronofsky",
            "Credit":"Director"
         },
         {  
            "Name":"Andres Heinz",
            "Credit":"Story"
         },
         {  
            "Name":"John J. McLaughlin",
            "Credit":"Screenplay"
         },
         {  
            "Name":"Mark Heyman",
            "Credit":"Screenplay"
         },
</snip>         

metacritic-api's People

Contributors

marcalencc avatar

Watchers

James Cloos avatar Luke avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.