This is the official API for the Matemine.shop marketplace, where you can browse and access data about video games.
Our data is sourced from Moby Games, and most routes in this API require token authentication for security. However, the /games route can be accessed directly from the browser without authentication.
Below, you'll find documentation for the /games route, including how to use its query parameters to filter, sort, and paginate your search results.
GET /games
This endpoint retrieves a list of games based on the provided filters, pagination, and sorting options.
nintendo: Specify a comma-separated list of Nintendo consoles (e.g., SNES, Wii).sega: Specify a comma-separated list of SEGA consoles (e.g., Genesis, Dreamcast).playstation: Specify a comma-separated list of PlayStation consoles (e.g., PSP, PlayStation 5).xbox: Specify a comma-separated list of Xbox consoles (e.g., Xbox, Xbox Series).Examples:
?nintendo=SNES,Wii
?sega=Genesis,Dreamcast
?playstation=PlayStation%205,PSP
?xbox=Xbox,Xbox%20Series
perPage: The number of games per page. Valid values: 12, 24, 48, 76. Default: 12.page: The page number to fetch. Must be a positive integer. Default: 1.Examples:
?perPage=24
?page=2
sort: Determines the sorting order of games. Valid values:
alpha-desc: Sort by title in descending order (Z → A).alpha-asc: Sort by title in ascending order (A → Z).rating-desc: Sort by rating in descending order.rating-asc: Sort by rating in ascending order.price-desc: Sort by price in descending order (highest → lowest).price-asc: Sort by price in ascending order (lowest → highest).Examples:
?sort=rating-asc
?sort=price-desc
{
"games": [
{
"game_id": 500,
"title": "Star Wars: Dark Forces",
"description": "Kyle Katarn is a former Imperial officer turned mercenary, now hired by the Rebel Alliance. After having stolen the Death Star plans ...",
"price": "36.31",
"rating": "7.90",
"sample_cover_image": "https://cdn.mobygames.com/covers/4144523-star-wars-dark-forces-dos-front-cover.jpg",
"sample_cover_thumbnail": "https://cdn.mobygames.com/64f827c0-aba7-11ed-99ae-02420a00019e.webp",
"available": true
},
...
],
"totalPages": 10
}
GET /games?nintendo=SNES,Wii&sort=rating-asc
GET /games?playstation=PlayStation%205,PSP&perPage=24&page=2
GET /games?xbox=Xbox,Xbox%20Series&sort=price-desc
GET /games?nintendo=Wii&sega=Genesis&xbox=Xbox%20Series
If an invalid parameter value is provided (e.g., unsupported sort option), the server will replace it with the default value,
alpha-desc in this case.
If no games match the specified filters, the server will return an empty response:
{
"games": [],
"totalPages": 0
}