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

> Itch provides 8 callable API endpoints through the Parse marketplace.

**Category:** Marketplaces | **Website:** [itch.io/](https://itch.io/) | **Docs:** [parse.bot/marketplace/a926b5dc-5a9f-4d3d-9d96-1bb80b22630b/itch-io-api](https://parse.bot/marketplace/a926b5dc-5a9f-4d3d-9d96-1bb80b22630b/itch-io-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-itch-io-api-a926b5dc/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_game_jams

Browse game jams on itch.io filtered by status. Returns jam details including title, host, timing, participant count, and ranking status. Each status tab shows a different set of jams.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Jam status filter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-itch-io-api-a926b5dc/browse_game_jams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"<string>"}'
```

### browse_games

Browse games on itch.io with various filters and sorting options. Returns paginated results with game metadata including title, creator, price, platforms, and thumbnails. The server returns an HTML fragment parsed into structured game objects. Pagination uses integer page numbers; an empty games array signals the end.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter_type` | string | No | Filter type to narrow results by category. |
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Sort order for results. |
| `tag` | string | No | Filter by tag slug (e.g. horror, roguelike, puzzle, 2d, 3d, pixel-art). |

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

### get_all_tags

Get all available top-level game tags from itch.io for categorization and filtering. Returns approximately 40 popular tags with their names and URLs.

**Estimated cost:** Metered

_No parameters required._

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

### get_creator_profile

Get creator profile information and their published games from their itch.io page. Returns name, bio, social links, and a list of games published by the creator.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the creator's itch.io page (e.g. https://developer.itch.io). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-itch-io-api-a926b5dc/get_creator_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_featured_games

Fetch featured games from the itch.io homepage. Returns games currently showcased on the front page. The selection changes over time as itch.io curates its homepage.

**Estimated cost:** Metered

_No parameters required._

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

### get_game_comments

Get comments/reviews for a specific game. Returns comments in reverse chronological order. Supports cursor-based pagination using the next_token value as the before parameter. Returns stale_input if the game has no comments page (404).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `before` | string | No | Pagination cursor from next_token to fetch older comments. |
| `url` | string | Yes | Full URL of the game page (e.g. https://developer.itch.io/game-name). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-itch-io-api-a926b5dc/get_game_comments \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"before":"<string>","url":"<string>"}'
```

### get_game_details

Get detailed information about a specific game on itch.io, including full description, metadata, downloadable files, rating, and tags. Requires the full game page URL. Returns a single game detail object parsed from the HTML page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the game page (e.g. https://developer.itch.io/game-name). |

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

### search_games

Search for games on itch.io by keyword. Returns matching game results from the full-text search index. Results are HTML-parsed from the search page. No has_more indicator is provided; an empty games array means no more results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword. |

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