Upcoming Games Data & Game Details API Documentation
Welcome to the comprehensive documentation for the
UpcomingGM API endpoint.
This API provides developers with realtime, live data about upcoming games as well as detailed game information when requested.
It is designed to simplify the integration process and allow you to showcase upcoming releases on your platform without any compromise.
The API offers two distinct operations: a simple list retrieval (fetch) and a more detailed information request (DataFor).
The entire system is designed with scalability and efficiency in mind, supporting multiple requests per day while enforcing a strict quota limit based on your plan.
All data is fetched live from trusted sources, ensuring the information you display is up-to-date.
🚫 Usage Limit Alert: Please note that this API is subject to daily usage limits.
Check your current quota usage in the API response and upgrade your plan if you require an increased limit.
🚨Parameter Restriction: The subSec parameter is not supported for the UpcomingGM endpoint.
Do not include subSec in your queries, or you will receive an error.
🚨 Security Warning: Never expose your useruid or api key in client-side code.
Keep these credentials securely on your server to prevent abuse and limit quota exhaustion.
Endpoint Parameters
To access the
UpcomingGM API, you must supply the following query parameters in your request:
| Parameter | Requirement | Description |
|---|---|---|
sectionName |
Required | Must be set to UpcomingGM to access the upcoming games data. |
type |
Required |
Specifies the operation type. Valid values are:
|
useruid |
Required | Your unique developer user id used for authentication and quota tracking. |
api |
Required | Your secret API key; ensure this remains confidential. |
url |
Conditional |
Required only when type=DataFor. Provide the full game URL to obtain its live detailed data.
|
subSec |
Not Supported | Do not include this parameter for the UpcomingGM endpoint. |
Error Responses
{"error":"Missing required parameters"}– Returned when one or more required parameters are omitted.{"error":"Auth Failed! Please Check Your User ID & Try Again.."}– Returned when the provideduseruidis invalid or non-existent.{"error":"Invalid API key. Obtain an official key from https://www.hlgamingofficial.com/p/api.html"}– Returned when the suppliedapikey does not match our records.{"error":"subSec is not allowed for UpcomingGM."}– Returned if thesubSecparameter is included.{"error":"Missing or invalid 'type' parameter. It should be either 'fetch' or 'DataFor'."}– Returned whentypeis absent or invalid.{"error":"Missing required 'url' parameter for DataFor type."}– Returned when aDataForrequest is made without aurl.{"error":"Server error or external API issue. Try again later."}– Indicates an internal or upstream error.
API Operations & Use Cases
The
UpcomingGM API is designed to serve two major purposes:
1. Fetch Operation (
type=fetch):
- Retrieves a live list of upcoming games in JSON format.
-
Each returned game object contains essential properties:
gameName: The name of the game.gameUrl: A direct link to the game’s store page.releaseDate: The scheduled release date.gameImage: A thumbnail image from the game’s store page.price: The cost, which is typicallyFreefor the upcoming games.credits: Always set to"HL Gaming Official HM"to clearly identify the data source.
- This operation is ideal for platforms wanting to display a dynamic list of upcoming titles.
2. DataFor Operation (
type=DataFor):
- Retrieves detailed live information for a specific game using the game’s URL.
-
The detailed response includes comprehensive data such as:
title: Game title.image: A larger, detailed image from the game’s store page.developerandpublisher: Names of the companies behind the game.releaseDate: The exact release date.description: A brief summary (if provided).systemRequirements: Contains bothminimumandrecommendedarrays with system specs.tags: An array of game genre and feature tags.trailer: Contains various video sources and a poster image URL.credits: Again set to"HL Gaming Official HM".
- This operation is perfect for applications that need rich game detail pages.
Note: Do not include the
subSec parameter as it is not applicable for these operations.
Example API Requests
Here are some example requests to help guide your integration:
1. Fetching Upcoming Games List:
curl -X GET "https://hl-gaming-official-main-api.vercel.app/api?sectionName=UpcomingGM&type=fetch&useruid=YOUR_USER_UID&api=YOUR_API_KEY"
2. Fetching Detailed Game Information:
Include the
Include the
url parameter with the game page URL as shown below:
curl -X GET "https://hl-gaming-official-main-api.vercel.app/api?sectionName=UpcomingGM&type=DataFor&url=https://store.steampowered.com/app/3103460/Storage_Guys/?snr=1_7_7_popularcomingsoon_150_1&useruid=YOUR_USER_UID&api=YOUR_API_KEY"
Example Output Responses
Below are sample responses from the API, allowing you to familiarize yourself with the expected data structures.
A. Successful
fetch Operation:
{
"source": "HL Gaming Official",
"endpoint": "UpcomingGM",
"result": [
{
"gameName": "Storage Guys",
"gameUrl": "https://store.steampowered.com/app/3103460/Storage_Guys/?snr=1_7_7_popularcomingsoon_150_1",
"releaseDate": "Apr 15, 2025",
"gameImage": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/3103460/9cdf1d49da9cd18461826acb97667f23474f6bf4/capsule_sm_120.jpg?t=1744620602",
"price": "Free",
"credits": "HL Gaming Official HM"
},
{
"gameName": "Sunset Motel",
"gameUrl": "https://store.steampowered.com/app/2616140/Sunset_Motel/?snr=1_7_7_popularcomingsoon_150_1",
"releaseDate": "Apr 18, 2025",
"gameImage": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/2616140/capsule_sm_120.jpg?t=1744369607",
"price": "Free",
"credits": "HL Gaming Official HM"
},
{
"gameName": "Lost Skies",
"gameUrl": "https://store.steampowered.com/app/1931180/Lost_Skies/?snr=1_7_7_popularcomingsoon_150_1",
"releaseDate": "Apr 18, 2025",
"gameImage": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/1931180/capsule_sm_120.jpg?t=1744654794",
"price": "Free",
"credits": "HL Gaming Official HM"
}
// ... additional game objects
],
"usage": {
"usedToday": 30,
"dailyLimit": 50,
"remainingToday": 20
}
}
B. Successful
DataFor Operation (Detailed Game Info):
{
"source": "HL Gaming Official",
"endpoint": "UpcomingGM",
"result": {
"title": "Storage Guys",
"image": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/3103460/9cdf1d49da9cd18461826acb97667f23474f6bf4/capsule_231x87.jpg?t=1744620602",
"developer": "Raynmakyr",
"publisher": "Raynmakyr",
"releaseDate": "Apr 15, 2025",
"description": "",
"systemRequirements": {
"minimum": [
"Requires a 64-bit processor and operating system",
"OS: Windows 10 - 64bit",
"Processor: Intel Core i5 / AMD Ryzen 5",
"Memory: 4 GB RAM",
"Graphics: NVIDIA GTX 970 / AMD Radeon R9 390",
"DirectX: Version 11",
"Network: Broadband Internet connection",
"Storage: 5 GB available space"
],
"recommended": [
"Requires a 64-bit processor and operating system",
"OS: Windows 10 - 64bit",
"Processor: Intel Core i5 / AMD Ryzen 5",
"Memory: 8 GB RAM",
"Graphics: NVIDIA GTX 1060 / AMD Radeon RX 480",
"DirectX: Version 11",
"Network: Broadband Internet connection",
"Storage: 5 GB available space"
]
},
"tags": [
"Simulation",
"Management",
"Multiplayer",
"Resource Management",
"Immersive Sim",
"Logic",
"Building",
"Economy",
"Indie",
"Automation",
"Sandbox",
"Casual",
"Inventory Management",
"Team-Based",
"Colorful",
"Realistic",
"3D",
"First-Person",
"Online Co-Op",
"Singleplayer"
],
"trailer": {
"videoTitle": "",
"webmSource": "https://video.cloudflare.steamstatic.com/store_trailers/257057614/movie480_vp9.webm?t=1743102092",
"webmHdSource": "https://video.cloudflare.steamstatic.com/store_trailers/257057614/movie_max_vp9.webm?t=1743102092",
"mp4Source": "https://video.cloudflare.steamstatic.com/store_trailers/257057614/movie480.mp4?t=1743102092",
"mp4HdSource": "https://video.cloudflare.steamstatic.com/store_trailers/257057614/movie_max.mp4?t=1743102092",
"poster": "https://shared.cloudflare.steamstatic.com/store_item_assets/steam/apps/257057614/9ad3a4925fddcb69d8136b988205ba23f2f06fc8/movie_600x337.jpg?t=1743102092"
},
"credits": "HL Gaming Official HM"
},
"usage": {
"usedToday": 31,
"dailyLimit": 50,
"remainingToday": 19
}
}
Obtaining Your Credentials
To use the
UpcomingGM API, you must have a valid developer user id (useruid) and secret API key (api).
Both credentials are provided upon registration and are essential for tracking your API usage as well as enforcing your daily quota.
| Credential | Description |
|---|---|
useruid |
Your unique developer identifier. This value is used for authentication and quota management. |
api |
Your secret API key. Keep this confidential to prevent unauthorized API usage. |
API Usage Examples
Integrate the UpcomingGM API quickly using the sample code provided below.
These examples cover several popular programming languages to help you get started without issues.
FAQ & Best Practices
Q1: What is the primary purpose of the UpcomingGM API?
A: The API is designed to deliver live data about upcoming games as well as detailed game information for a given game URL. This enables developers to display dynamic game release data and rich details on their applications.
Q2: How do I choose between
fetch and DataFor operations?
A: Use
fetch when you need a complete list of upcoming game titles along with basic details (name, URL, release date, image, price, and credits). Use DataFor when you require in-depth details for a specific game, including system requirements, tags, and trailer information.
Q3: What are the usage limits and how can I monitor my daily quota?
A: Each response includes a
usage object with details on usedToday, your total dailyLimit, and the remainingToday count. This helps you monitor your daily API call quota.
Q4: What security measures should I follow?
A: Never expose your credentials (
useruid and api) in your front-end or client-side code. Always perform API calls from your server to secure your keys and usage.
Best Practices:
- Cache responses where possible to minimize API calls.
- Handle error responses gracefully and provide fallback content for your users.
- Regularly monitor your API usage and upgrade your plan if you are nearing the limit.
- Maintain secure storage of your credentials.
HL Gaming Official Upcoming Games Data & Game Details API Documentation © 2025
