kingshot-giftcode.centurygame.com APIkingshot-giftcode.centurygame.com ↗
Redeem King's Shot gift codes, look up players by ID, and fetch gift code center config via 3 dedicated endpoints. JSON responses with reward data and error codes.
curl -X POST 'https://api.parse.bot/scraper/ea8ff0bc-09f9-419a-a710-2374107ef49c/get_player' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Look up a King's Shot player by their in-game player ID. Returns player information if the ID exists, or an error response (code=1, err_code=40001) if the player is not found. The player ID can be found in-game through the avatar in the top left corner.
| Param | Type | Description |
|---|---|---|
| fidrequired | string | The player's in-game ID (numeric string found via the in-game avatar). |
{
"type": "object",
"fields": {
"msg": "string status message from the API",
"code": "integer indicating success (0) or failure (1)",
"data": "object containing player details when found, or empty array when not found",
"err_code": "integer error code (0 for success, 40001 for player not found)"
},
"sample": {
"msg": "role not exist.",
"code": 1,
"data": [],
"err_code": 40001
}
}About the kingshot-giftcode.centurygame.com API
The King's Shot Gift Code API exposes 3 endpoints for interacting with the Kingshot mobile game redemption center at kingshot-giftcode.centurygame.com. Use get_player to verify a player exists by their in-game numeric ID, redeem_code to submit a gift code and receive reward item data in return, and get_gift_code_config to retrieve promotional banner URLs for each supported language. All responses include a code field and an err_code for precise error handling.
Player Lookup
The get_player endpoint accepts a single required parameter, fid, which is the numeric player ID visible in-game via the avatar in the top-left corner. A successful response returns code: 0 along with a data object containing player details. If no player matches the supplied fid, the response returns code: 1 and err_code: 40001. This lets you validate player IDs before attempting redemption, reducing wasted requests.
Gift Code Redemption
The redeem_code endpoint takes both fid (player ID) and code (the alphanumeric gift code, case-sensitive). On success, data contains an array of reward items granted to the player. Failure states are communicated through err_code: 40014 signals the gift code was not found or is invalid, while 40001 indicates the player ID does not exist. Codes must be redeemed per-player — there is no batch redemption across multiple fid values in a single request.
Gift Code Center Configuration
The get_gift_code_config endpoint requires no parameters and returns a data object keyed by language code. Each language entry contains pc_banner and mob_banner URL strings pointing to the promotional imagery for that locale. This is useful for building localized redemption UIs that mirror the official gift code center's appearance.
- Validate a King's Shot player ID before presenting a gift code redemption form
- Build a self-service redemption tool where players enter their
fidand acodeto claim in-game rewards - Display language-specific promotional banners from
get_gift_code_configin a web or mobile redemption portal - Surface clear error messages to users by mapping
err_codevalues (40001, 40014) to human-readable feedback - Track redemption outcomes by logging
datareward arrays returned from successfulredeem_codecalls - Automate gift code distribution campaigns by iterating over a list of player IDs and submitting codes programmatically
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does King's Shot or Century Games offer an official public developer API for gift code redemption?+
What does `redeem_code` actually return on a successful redemption?+
code: 0, err_code: 0), the data field contains an array of reward items that were granted to the player. On failure, data is an empty array and err_code identifies the reason: 40014 means the gift code was not found or is invalid, and 40001 means the player ID does not exist.Can I look up a player's game stats, inventory, or match history through this API?+
get_player returns for a given fid, scoped to the gift code center context. Game stats, inventory, and match history are not covered. You can fork this API on Parse and revise it to add endpoints targeting other King's Shot data surfaces if they become available.Is there a way to list all currently valid gift codes through this API?+
Are gift codes case-sensitive, and can the same code be redeemed more than once per player?+
code parameter passed to redeem_code is case-sensitive. Attempting to redeem a code that has already been used by the same player, or one that does not exist, returns err_code: 40014. The API response does not distinguish between an already-used code and a completely invalid one — both surface the same error code.