GGscore API Introduction#
GGscore API Provides developers with interfaces for both HTTP and WebSocket protocols, allowing them to access various types of data services. The returned results support the JSON format.We recommend choosing the data retrieval protocol based on the application scenario (you can also use a combination). Primarily use HTTP to retrieve data; for data with low update frequency, use the HTTP protocol, while high-frequency or real-time data should be retrieved through WebSocket.。The GGscore API is open to all users. Before using this set of services, you need to apply for an app_id and app_secret. Different types of users can obtain different levels of data access capabilities.HTTP Protocol#
Global Request Parameters#
| PARAM | VALUE |
|---|
| base_url * | https://api.esportsdata.cc |
| app_id | Obtained from the console, used for identity verification |
| app_secret | Obtained through a business application, used for permission verification |
All global interfaces support both HTTP and HTTPS. Each interface requires the transmission of app_id and app_secret to verify interface permissions. Data can only be accessed by making requests from whitelisted IPs (proxy mode is not supported).Global Response Structure#
| PARAM | VALUE |
|---|
| code | Status Code |
| data | Main Returned Data |
| msg | Request Status |
websocket Protocol#
WSConnection Parameters#
| PARAM | VALUE |
|---|
| base_url * | wss://ws.esportsdata.cc |
| app_id | Obtained from the console, used for identity verification |
| app_secret | Obtained through a business application, used for permission verification |
All global WebSocket addresses support both WS and WSS. Each WebSocket requires the transmission of app_id and app_secret to verify WebSocket permissions. Data can only be accessed by subscribing from whitelisted IPs (proxy mode is not supported).Global Response Structure#
| PARAM | VALUE |
|---|
| channel | Push Type |
| push_type | Push Types (new for additions; update for changes) |
| data | Main Returned Data |
| push_time_millis | Push Time, millisecond-level timestamp |
Account and Key Application##
Registering as a GGscore developer requires four steps:Step 1: Register as a developer
After registration, please go to the console to bind a business representative.Step 2: Complete identity verification
In the console under the account management module, you can choose personal verification or enterprise verification based on your type. The service call volume differs for individuals and enterprises. If you require higher service call frequencies, you can contact the business representative to upgrade your account.Step 3: Contact the business representative to activate permissions
Contact the business representative to apply for the product you want to try. Once the trial is activated, you can generate the app_id and app_secret in the console, along with the trial permissions for the product.Step 4: Configure the IP whitelist
In the console under access management, set the access IPs. Each customer can configure up to 3 access IPs (production environment, testing environment, pre-release environment).SDK Integration Demo#
We provide integration demos for JAVA, PHP, and GOlang SDKs. For other languages, you can implement them yourself. For details, refer to the integration guide.Usage Restrictions#
Integration Restrictions#
Except for animated live broadcasts and embedded components, other interfaces and push notifications cannot be directly applied to the front end. All data must be pulled to the user's server and then integrated into the user's product front end through development.Request Rate Limits#
Total request frequency per minute: 1200 requests (for the same app_id).
Request frequency per individual API: Each interface has its own request frequency limit. Refer to the specific interface documentation for details.
For more information, see the integration guide.
WebSocket Connection Limits#
For the same data on the same IP, only one client connection is allowed to be online.
After all WebSocket connections are disconnected, wait a few seconds before reconnecting. Continuous reconnection is not allowed.
Request frequency per individual API: Each interface has its own request frequency limit. Refer to the specific interface documentation for details.
For more information, see the integration guide.
Notes#
1.
To better serve users, basic service call volumes have certain limits. If you require higher service call volumes, please contact the business representative to upgrade your account.
2.
This product is for the user's own use only. It is strictly prohibited to share or sell it to others.
3.
Use of this product must strictly comply with local laws and regulations. We have zero tolerance for illegal activities. You must ensure that your application, as well as your use of this service, related content, related data, related products, and any behavior or purpose involving this product, does not violate any applicable laws, regulations, rules, norms, policies, administrative orders, regulatory requirements, mandatory national standards, or other legally binding standards (collectively referred to as "laws and regulations"). In case of violation, this product's services will be terminated at any time, and all responsibilities must be borne by the user.
Modified at 2025-06-18 10:29:18
