Ludoria API
Welcome to the Ludoria API documentation. Our API provides programmatic access to the entire game library, allowing you to search, filter, and retrieve game details and images.
Base URL
https://www.ludoria.kekesmovic.com.ng/api/
Endpoints
GET
/api/index.php
Retrieve a paginated list of all games.
| Parameter | Type | Required | Description |
|---|---|---|---|
page |
Integer | No | Page number (default: 1) |
perPage |
Integer | No | Items per page (default: 100, max: 200) |
genre |
String | No | Filter by genre (e.g., "Action") |
alpha |
String | No | Filter by starting letter or "0" for numbers |
Example Request
GET /api/index.php?page=1&perPage=50
GET
/api/search.php
Search for games by name, platform, or developer.
| Parameter | Type | Required | Description |
|---|---|---|---|
q |
String | Yes | Search query |
page |
Integer | No | Page number (default: 1) |
perPage |
Integer | No | Items per page (default: 100, max: 200) |
GET
/api/game.php
Get detailed information for a specific game.
| Parameter | Type | Required | Description |
|---|---|---|---|
id |
Integer | Yes | The game's DatabaseID |
Example Response
{
"id": 123,
"name": "Super Mario 64",
"platform": "Nintendo 64",
"releaseDate": "1996-06-23",
"developer": "Nintendo EAD",
"publisher": "Nintendo",
"genres": "Platform",
"overview": "Super Mario 64 is a 1996 platform game...",
"mainImage": {
"filename": "Nintendo 64/Box - Front/Super Mario 64.jpg",
"image": "..."
},
"images": [ ... ]
}
GET
/api/platform.php
List all platforms or games for a specific platform.
| Parameter | Type | Required | Description |
|---|---|---|---|
platform |
String | No | If provided, lists games for that platform. If omitted, lists all available platforms. |
page |
Integer | No | Page number (for game list) |
perPage |
Integer | No | Items per page (default: 100, max: 200) |
GET
/api/genre.php
List all genres or games for a specific genre.
| Parameter | Type | Required | Description |
|---|---|---|---|
genre |
String | No | If provided, lists games for that genre. If omitted, lists all available genres. |
page |
Integer | No | Page number (for game list) |
perPage |
Integer | No | Items per page (default: 24, max: 200) |
GET
/api/alpha.php
Browse games alphabetically.
| Parameter | Type | Required | Description |
|---|---|---|---|
alpha |
String | Yes | Letter (A-Z) or "0" for numbers. |
page |
Integer | No | Page number |
perPage |
Integer | No | Items per page (default: 100, max: 200) |