# Kinguin — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Kinguin's gaming catalog to find products, compare offers, and read user reviews, or browse trending games, bestsellers, and new releases. Get detailed product information to make informed purchasing decisions across their entire inventory.

**Category:** Marketplaces | **Website:** [kinguin.net/](https://kinguin.net/) | **Docs:** [parse.bot/marketplace/8f26da99-869f-4ae2-bfc7-17621ae5a72a/kinguin-net-api](https://parse.bot/marketplace/8f26da99-869f-4ae2-bfc7-17621ae5a72a/kinguin-net-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bestsellers

Retrieve the current bestselling products on Kinguin. Returns products sorted by total sales volume with pagination support.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Zero-based page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/get_bestsellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### get_new_releases

Browse newly released products on Kinguin. Returns products sorted by creation date (newest first) with pagination support.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Zero-based page number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/get_new_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>"}'
```

### get_product_details

Retrieve full metadata for a specific product by its hex ID. Returns detailed product information including attributes, pricing, breadcrumbs, and links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Hexadecimal product ID (24-character MongoDB ObjectId). Obtainable from search_products results via hits[*].id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_product_offers

Retrieve all available seller offers for a specific product by its slug. Returns offer prices, seller info, and product metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug in format externalId/url-key (e.g. 498667/gothic-1-remake-pc-steam-cd-key). Constructable from search_products results using hits[*].externalId and hits[*].attributes.urlKey. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/get_product_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_product_reviews

Get user reviews for a specific product. Returns a paginated list of reviews with ratings and average score.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Zero-based page number. |
| `product_id` | string | Yes | Hexadecimal product ID (24-character MongoDB ObjectId). Obtainable from search_products results via hits[*].id. |
| `size` | integer | No | Number of reviews per page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","product_id":"<string>","size":"<integer>"}'
```

### get_trending

Get the current trending search terms on Kinguin.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/get_trending \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Search for products by keyword with optional sorting and filtering. Returns paginated results from Kinguin's catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filters` | string | No | JSON-encoded object of filter key-value pairs passed as query params. |
| `limit` | integer | No | Number of results per page. |
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | No | Search keyword (e.g. elden ring, windows 11). |
| `sort` | string | No | Sort order as field,direction. Accepted values: bestseller.total,DESC, createDate,DESC, price.lowestOffer,ASC, price.lowestOffer,DESC. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-kinguin-net-api-8f26da99/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","sort":"<string>"}'
```