GET: Games by search |

/v1/game/search/{search_term}

Attributes

search_term

String: URL encoded search term.

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.

Year

Boolean: Returned game must have a year set.

Youtube

Boolean: Returned game must have a youtube video set.

Site

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

Example

Searching for “Super Mario Bros. 2.

Endpoint

/v1/game/search/Super+Mario+Bros.+2

Response

{
    "Term": "super mario bros. 2",
    "Requester": "f13",
    "Route": "https://retrocrypt.com/rest/v1/search/super+mario+bros.+2",
    "Status": "200",
    "Message": "success",
    "Result_count": 1,
    "Results": [
        {
            "Game": {
                "ID": "50586",
                "Title": "Super Mario Bros. 2",
                "Description": "",
                "Picture": "",
                "Year": "1988",
                "Youtube": "",
                "Developer": "Nintendo Research & Development 4",
                "Publisher": "Nintendo",
                "URL": "https://nes.retrocrypt.com/game/50586/Super+Mario+Bros.+2/",
                "Site": {
                    "ID": "5",
                    "Slug": "NES",
                    "Title": "RetroCrypt NES",
                    "URL": "https://nes.retrocrypt.com"
                },
                "Routes": { 
                    "Year": "https://retrocrypt.com/rest/v1/year/1988",
                    "Developer": "https://retrocrypt.com/rest/v1/developer/Nintendo+Research+%26+Development+4",
                    "Publisher": "https://retrocrypt.com/rest/v1/publisher/Nintendo",
                    "Cheats": "https://retrocrypt.com/rest/v1/game/cheats/50586",
                    "Game": "https://retrocrypt.com/rest/v1/game/50586"
                }
            }
       }
    ]
}

Documentation