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

> Discover and browse thousands of free online games with detailed information about genres, popularity, and platform compatibility. Find new games by exploring categories or searching through Poki's complete game catalog to access metadata and recommendations.

**Category:** Entertainment | **Website:** [poki.com/](https://poki.com/) | **Docs:** [parse.bot/marketplace/2c822e07-8a3c-459e-9c33-4bcdb0f02408/poki-com-api](https://parse.bot/marketplace/2c822e07-8a3c-459e-9c33-4bcdb0f02408/poki-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-poki-com-api-2c822e07/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_games

List games within a specific category. Returns game objects with basic metadata for games matching the given category slug. The limit parameter caps how many games are returned (default 1000 covers most categories entirely).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | The slug of the category (e.g. 'action'). Obtain from list_categories.categories. |
| `limit` | integer | No | Maximum number of games to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-poki-com-api-2c822e07/get_category_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","limit":"<integer>"}'
```

### get_game_details

Get detailed information for a specific game by its slug, including title, developer, genres, popularity metrics, and platform compatibility. Returns input_not_found when the slug does not match any game.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The unique game slug identifier (e.g. 'subway-surfers'). Obtain from list_games.game_slugs or get_category_games.games[*].slug. |

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

### list_categories

List all available game category slugs on Poki.com. Returns category identifiers usable with get_category_games. The full list contains ~180 categories.

**Estimated cost:** Metered

_No parameters required._

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

### list_games

List all game slugs available on Poki.com by parsing the sitemap. Returns the complete catalog of game identifiers. The full catalog contains ~1500 games; no pagination or filtering is available.

**Estimated cost:** Metered

_No parameters required._

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