# Kinguin — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/kinguin/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/kinguin/get-bestsellers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kinguin/get-new-releases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kinguin/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kinguin/get-product-offers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kinguin/get-product-reviews \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kinguin/get-trending \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/kinguin/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"filters":"<string>","limit":"<integer>","page":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.