RESTful API for accessing gaming console and variation data.
All API requests require authentication using an API key in the Authorization header:
Base URL: https://api.getgames.app
API requests are limited to 120 requests per minute per IP address to ensure service reliability.
Rate limit headers:
429 Too Many Requests: {"error": "Rate limit exceeded", "message": "Too many requests. Maximum 120 requests per minute allowed.", "retry_after": 60}
Test any endpoint directly from this page:
Retrieve all gaming consoles.
[
{"id": 1, "name": "Nintendo Switch"},
{"id": 2, "name": "Nintendo Switch 2"},
{"id": 3, "name": "PlayStation 5"}
]
Retrieve a specific console information only.
{
"id": 1,
"name": "Nintendo Switch"
}
Retrieve all variations for a specific console.
[
{
"id": 1,
"variation_name": "OLED - White",
"console_id": 1,
"release_date": "2021-10-08",
"product_code": "HEG-KAAAA-EUR",
"upc": "",
"base_console": "Nintendo Switch",
"region_name": "Europe"
}
]
Retrieve all variations across all consoles.
[
{
"id": 1,
"variation_name": "OLED - White",
"console_id": 1,
"product_code": "HEG-KAAAA-EUR",
"upc": "",
"base_console": "Nintendo Switch",
"region_id": 1,
"release_date": "2021-10-08",
"region_short_name": "EU",
"region_name": "Europe"
}
]
Retrieve a specific variation by ID.
{
"id": 1,
"name": "OLED - White",
"console_id": 1,
"release_date": "2021-10-08",
"product_code": "HEG-KAAAA-EUR",
"upc": "",
"base_console": "Nintendo Switch",
"region_short_name": "EU",
"region_name": "Europe"
}
Retrieve all available regions.
[
{"id": 1, "name": "Europe", "short_name": "EU"},
{"id": 2, "name": "North America", "short_name": "US"},
{"id": 3, "name": "Japan", "short_name": "JP"}
]
Retrieve all console manufacturers.
[
{"id": 1, "name": "Nintendo"},
{"id": 2, "name": "Sony"},
{"id": 3, "name": "Microsoft"}
]
Search for variations by UPC code. Perfect for barcode scanning in mobile apps.
[
{
"id": 4,
"variation_name": "OLED - The Legend of Zelda: Tears of the Kingdom Edition",
"console_id": 1,
"product_code": "HEG-KDAAA-EUR",
"upc": "045496453572",
"base_console": "Nintendo Switch",
"region_id": 1,
"release_date": "2023-04-28",
"region_short_name": "EU",
"region_name": "Europe"
}
]
Note: Returns empty array [] if no variations found with the given UPC.
Crowdsourced UPC to TGDB game ID mapping system. Submit barcodes from your app and query approved mappings.
Submit barcode(s) with TGDB game ID for admin review. Supports both single and batch submissions.
Single submission:
{
"message": "Barcode submitted successfully",
"submission_id": 42
}
Batch submission:
{
"message": "Barcodes submitted successfully",
"count": 2
}
Query approved barcode mappings. Returns all TGDB game IDs associated with a UPC (one-to-many relationship).
{
"upc": "045496730451",
"mappings": [
{
"id": 1,
"upc": "045496730451",
"tgdb_game_id": 12345,
"times_queried": 42,
"source": "import",
"created_at": "2025-01-15 10:30:00",
"updated_at": "2025-01-15 10:30:00"
}
],
"count": 1
}
Note: Returns empty array in mappings if no approved mappings exist for the UPC.
Get statistics about pending submissions and approved mappings.
{
"pending_submissions": 15,
"approved_mappings": 30542
}
The API returns clean error responses with appropriate HTTP status codes:
Perfect for mobile apps! All responses are in clean JSON format with consistent structure.
🔍 Barcode Scanning: Use the UPC search endpoint with barcode scanner libraries like AVFoundation to instantly lookup variations by scanning their UPC codes.