kinguin.net APIkinguin.net ↗
Access Kinguin's game key catalog via API. Search products, compare seller offers, read user reviews, and browse bestsellers and new releases.
curl -X GET 'https://api.parse.bot/scraper/3b02dd55-3ca3-47f0-b4ac-81c8f06d8c0b/search_products?limit=5&query=elden+ring' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional sorting and filtering. Returns paginated results from Kinguin's catalog.
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-based page number for pagination. |
| sort | string | Sort order as field,direction. Accepted values: "bestseller.total,DESC", "createDate,DESC", "price.lowestOffer,ASC", "price.lowestOffer,DESC". |
| limit | integer | Number of results per page. |
| query | string | Search keyword (e.g. "elden ring", "windows 11") |
| filters | string | JSON-encoded object of filter key-value pairs passed as query params (e.g. {"platform": 2, "genres": 1}). |
{
"type": "object",
"fields": {
"hits": "array of product objects with id, name, price, attributes, etc.",
"page": "current page number (zero-based)",
"nbHits": "total number of matching products",
"nbPages": "total number of pages",
"hitsPerPage": "number of results per page"
},
"sample": {
"data": {
"hits": [
{
"id": "69e74989f593ce0667543b7c",
"name": "Elden Ring Accounts > PC > Elden Ring Nightreign PC Steam Account",
"price": {
"calculated": 2059,
"lowestOffer": 2059,
"subscription": 1956
},
"attributes": {
"urlKey": "elden-ring-accounts-pc-elden-ring-nightreign-pc-steam-account",
"platform": 13
},
"externalId": "497760"
}
],
"page": 0,
"nbHits": 492,
"nbPages": 99,
"hitsPerPage": 5
},
"status": "success"
}
}About the kinguin.net API
This API provides 7 endpoints covering Kinguin's digital game key marketplace, returning product metadata, seller offers, user reviews, trending searches, bestsellers, and new releases. The get_product_offers endpoint returns a full list of seller offers for a given product slug, including per-offer prices and seller details. The search_products endpoint supports keyword queries, platform and genre filters, and multiple sort strategies with paginated results.
Search and Browse
The search_products endpoint accepts a query string (e.g. "elden ring") and an optional filters parameter — a JSON-encoded object supporting keys like platform and genres. Results come back paginated with hits, nbHits, nbPages, and hitsPerPage fields. Sort order is controlled via the sort parameter, accepting values such as "bestseller.total,DESC" or "createDate,DESC". get_bestsellers and get_new_releases are convenience wrappers that return the same hits shape sorted by sales volume and creation date respectively, both accepting page and limit params.
Product Details and Offers
get_product_details takes a 24-character hex product ID (a MongoDB ObjectId obtainable from search_products results) and returns full metadata: name, price (with lowestOffer, calculated, and subscription sub-fields, all in cents), attributes including platform, genres, region, keywords, and urlKey, plus breadcrumbs and an externalId. The get_product_offers endpoint uses a slug in the format "<externalId>/<url-key>" and returns offers.mainOffer, a paginated offers.collection with per-seller pricing, product images, videos, and an optional description string.
Reviews and Trending
get_product_reviews accepts a hex product ID with optional page and size params. The response includes a _embedded.productReviewList array of individual review entries alongside aggregate reviewRate and reviewCount fields. get_trending requires no inputs and returns a searches array of currently trending search terms on Kinguin, useful for surfacing popular titles in real time.
- Track the lowest seller offer price for a specific game key by polling
get_product_offerson a schedule - Build a game price comparison tool using
search_productsfiltered by platform and region - Display aggregated review scores and individual comments using
get_product_reviewsalongside product listings - Populate a 'trending games' section using the
get_trendingendpoint'ssearchesarray - Sync a game catalog with current bestseller rankings via
get_bestsellerswith pagination - Monitor new game key listings by regularly querying
get_new_releasessorted bycreateDate,DESC - Resolve full product metadata (platform, genre, region, price) from a search hit's hex ID using
get_product_details
| 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 Kinguin have an official developer API?+
How do I get seller offer prices for a specific product?+
get_product_offers returns an offers object containing mainOffer (the featured listing) and a collection array of individual seller offers with per-offer pricing. The slug input must be in the format "<externalId>/<url-key>" — both values are available from get_product_details via the externalId field and attributes.urlKey.What does the price field in `get_product_details` represent?+
price object contains three sub-fields: lowestOffer, calculated, and subscription, all expressed in cents (integer). For example, a lowestOffer value of 599 represents $5.99. Offers with live per-seller breakdowns are returned by get_product_offers rather than this field.Does the API expose purchase history, order status, or user account data?+
Are product IDs stable across searches?+
search_products hits are 24-character MongoDB ObjectIds and are consistent across search_products, get_product_details, and get_product_reviews. However, get_product_offers uses a slug format (externalId/url-key) rather than the hex ID, so you may need to call get_product_details first to assemble the correct slug.