# Opencritic — 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.

> Find and compare video game reviews and critic scores from industry experts, search games by title or filters, and browse detailed metadata including platforms, tags, and the latest releases. Get aggregated ratings and comprehensive review information to discover games and make informed purchasing decisions.

**Category:** Reviews & Ratings | **Website:** [opencritic.com/](https://opencritic.com/) | **Docs:** [parse.bot/marketplace/b0b1bc08-b32f-48fa-83ce-4c6abe25480a/opencritic-com-api](https://parse.bot/marketplace/b0b1bc08-b32f-48fa-83ce-4c6abe25480a/opencritic-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-opencritic-com-api-b0b1bc08/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_game_details

Get comprehensive metadata for a specific game by its numeric ID. Returns the full detail object including description, images, scores, trailers, platforms, genres, companies, rating, and a review summary. This is a heavier call than list_games — use for drill-down after identifying a game via search or listing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | integer | Yes | The unique numeric ID of the game. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opencritic-com-api-b0b1bc08/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<integer>"}'
```

### get_game_reviews

Get critic reviews for a specific game, paginated at 20 reviews per page. Each review includes the outlet name, author, score, snippet, publication date, and external URL. Reviews are ordered by publication date descending.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | integer | Yes | The unique numeric ID of the game. |
| `page` | integer | No | The page number to retrieve. Each page contains 20 reviews. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opencritic-com-api-b0b1bc08/get_game_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<integer>","page":"<integer>"}'
```

### get_latest_updates

Get the 20 most recently released games, sorted by release date descending. Returns summary metadata without full details. Useful for tracking new releases without specifying sort parameters manually.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opencritic-com-api-b0b1bc08/get_latest_updates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_platforms

Get the complete list of all supported gaming platforms. Each platform has an id, display name, short name, ordering priority, and image path. The list is static and rarely changes.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opencritic-com-api-b0b1bc08/get_platforms \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_tags

Get the complete list of all game tags used for categorization. Each tag has a name, tag_id slug, activity status, and popularity score. Tags are used to filter and categorize games by genre/style.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opencritic-com-api-b0b1bc08/get_tags \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_games

List games with pagination and optional sorting. Returns 20 games per page. Sort determines the ordering: by critic score, release date, name, review count, or recommendation percentage. Games include summary metadata (score, tier, platforms, genres) but not full details like descriptions or trailers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | The page number to retrieve. Each page contains 20 games. |
| `sort` | string | No | Sort order for the game list. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-opencritic-com-api-b0b1bc08/list_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","sort":"<string>"}'
```

### search_games

Search for games by title. Returns up to 20 matching results ranked by relevance (lower dist value means higher relevance). Results are lightweight — use get_game_details for full metadata on a match.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | The search term (game title or partial title). |

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