1. Home
  2. Docs
  3. Documentation
  4. Games
  5. GET: Games by year

GET: Games by year

/v1/game/year/{year}

Attributes

year

Integer: A numeric year.

Optional parameters

Optional parameters are included via the query string, optional parameters for the random game route are:

Picture

Boolean: Returned game must include an image.

Developer

Boolean: Returned game must have a developer set.

Publisher

Boolean: Returned game must have a publisher set.

Youtube

Boolean: Returned game must have a youtube video set.

Site

String: Return a random game from the given site id.

Example

In this example we will list all games released in the year 1988.

Endpoint

/v1/year/1988

Response

{
    "Requester": "f13",
    "Route": "https://api.retrocrypt.com/rest/v1/year/1988",
    "Status": "200",
    "Message": "Success",
    "Result_count": 104,
    "Results": [
        {
            "Game": {
                "ID": "2373",
                "Title": "Jordan vs. Bird: One on One",
                "Description": "",
                "Picture": "https://md.retrocrypt.com/inc/game_images/1586119777.jpg",
                "Year": "1988",
                "Youtube": "https://www.youtube.com/embed/MI8GxA9niZo",
                "Developer": "Electronic Arts",
                "Publisher": "Electronic Arts",
                "URL": "https://md.retrocrypt.com/game/2373/Jordan+vs.+Bird%3A+One+on+One/",
                "Site": {
                    "ID": "2",
                    "Slug": "MD",
                    "Title": "RetroCrypt Mega Drive",
                    "URL": "https://md.retrocrypt.com"
                },
                "Routes": {
                    "Year": "https://api.retrocrypt.com/rest/v1/year/1988",
                    "Developer": "https://api.retrocrypt.com/rest/v1/developer/Electronic+Arts",
                    "Publisher": "https://api.retrocrypt.com/rest/v1/publisher/Electronic+Arts",
                    "Cheats": "https://api.retrocrypt.com/rest/v1/game/cheats/2373",
                    "Game": "https://api.retrocrypt.com/rest/v1/game/2373"
                }
            }
        },
        ....
        {
            "Game": {
                "ID": "50708",
                "Title": "Zelda II: The Adventure of Link",
                "Description": "",
                "Picture": "",
                "Year": "1988",
                "Youtube": "",
                "Developer": "Nintendo Research & Development 4",
                "Publisher": "Nintendo",
                "URL": "https://nes.retrocrypt.com/game/50708/Zelda+II%3A+The+Adventure+of+Link/",
                "Site": {
                    "ID": "5",
                    "Slug": "NES",
                    "Title": "RetroCrypt NES",
                    "URL": "https://nes.retrocrypt.com"
                },
                "Routes": {
                    "Year": "https://api.retrocrypt.com/rest/v1/year/1988",
                    "Developer": "https://api.retrocrypt.com/rest/v1/developer/Nintendo+Research+%26+Development+4",
                    "Publisher": "https://api.retrocrypt.com/rest/v1/publisher/Nintendo",
                    "Cheats": "https://api.retrocrypt.com/rest/v1/game/cheats/50708",
                    "Game": "https://api.retrocrypt.com/rest/v1/game/50708"
                }
            }
        }
    ]
}