# Allkeyshop — 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 for games and compare CD key prices across multiple sellers to find the best deals, while tracking price history and viewing detailed store information. Get instant access to current game offers and pricing data to make informed purchasing decisions.

**Category:** Marketplaces | **Website:** [allkeyshop.com/](https://allkeyshop.com/) | **Docs:** [parse.bot/marketplace/2eb183a6-2721-499e-a492-c9437fd1f47d/allkeyshop-com-api](https://parse.bot/marketplace/2eb183a6-2721-499e-a492-c9437fd1f47d/allkeyshop-com-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-allkeyshop-com-api-2eb183a6/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_game_info

Get metadata for a specific game product page including title, HTML description, cover image URL, aggregate user rating, and the numeric product_id needed by get_game_price_history. Extracted from structured LD+JSON on the product page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The game slug from search_games results (e.g. 'buy-elden-ring-cd-key-compare-prices') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allkeyshop-com-api-2eb183a6/get_game_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_game_offers

Get all seller price offers for a specific game product page. Returns structured offer data including store name, rating, activation platform, region, edition, price with and without payment fees, and any coupon codes. Also returns the full merchants and editions lookup tables. The slug is obtained from search_games results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The game slug from search_games results (e.g. 'buy-elden-ring-cd-key-compare-prices') |
| `sort_by` | string | No | Sort offers by 'price' (base price) or 'price_with_fees' (price including payment processing fees) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allkeyshop-com-api-2eb183a6/get_game_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","sort_by":"<string>"}'
```

### get_game_price_history

Get historical price data for a game. Returns time-series price entries across merchants, editions, and regions, along with lookup tables for editions/regions/merchants and the lowest recorded prices from official and keyshop sellers. The product_id is obtained from get_game_offers or get_game_info results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID of the game (e.g. '29109'). Obtainable from get_game_info or get_game_offers results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allkeyshop-com-api-2eb183a6/get_game_price_history \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_store_info

Get information about a specific seller/store listed on AllKeyShop, including trust rating, review count, accepted payment methods, and whether it is an official seller. Data is extracted from a game product page's merchant list. If store_id is omitted, returns all merchants on the page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | No | Game slug to use for extraction. If omitted, defaults to 'buy-elden-ring-cd-key-compare-prices'. |
| `store_id` | string | No | Numeric store ID to fetch a specific merchant. If omitted, returns all merchants on the page. Store IDs are available in get_game_offers results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allkeyshop-com-api-2eb183a6/get_store_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","store_id":"<string>"}'
```

### search_games

Full-text search over AllKeyShop's game catalog by title. Returns matching games with slugs usable as identifiers for detail/offers endpoints, platform tags, current best price, and thumbnail images. Results are server-ranked by relevance; no pagination — the response is a single page of top matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Game title to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-allkeyshop-com-api-2eb183a6/search_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```