# Pixel Joint — 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.

> Browse and discover pixel art from the Pixel Joint community by searching gallery listings and viewing detailed information about individual artworks. Get access to artwork metadata, artist information, and gallery collections to explore the pixel art community's creative work.

**Category:** Entertainment | **Website:** [pixeljoint.com/](https://pixeljoint.com/) | **Docs:** [parse.bot/marketplace/70ace188-114c-430c-b754-ced14202a22d/pixeljoint-com-api](https://parse.bot/marketplace/70ace188-114c-430c-b754-ced14202a22d/pixeljoint-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-pixeljoint-com-api-70ace188/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artwork_details

Get detailed information about a specific pixel artwork including its canvas dimensions (width and height in pixels), full-resolution image URL, artist, post date, and engagement stats. The canvas_width and canvas_height fields represent the actual pixel art canvas size.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artwork_id` | string | Yes | Numeric artwork ID from Pixel Joint (e.g. '17123'). Found in artwork URLs like pixeljoint.com/pixelart/17123.htm, or from list_artworks results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pixeljoint-com-api-70ace188/get_artwork_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"artwork_id":"<string>"}'
```

### list_artworks

List pixel artworks from the Pixel Joint gallery with optional sorting and canvas size filtering. Results are paginated with 24 artworks per page. Use the dim and dimo parameters to filter artworks by canvas dimensions — for example, dimo='>=' with dim='96' returns artworks whose canvas is at least 96 pixels. Results are auto-iterated across pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `dim` | string | No | Canvas dimension filter value. Accepted values: 10, 16, 32, 48, 50, 64, 96. Represents the pixel dimension threshold for filtering (e.g. 96 means 96x96). |
| `dimo` | string | No | Canvas dimension comparison operator used with dim. Accepted values: '>=', '=', '<='. |
| `keyword` | string | No | Keyword to filter artworks by title. |
| `page` | integer | No | Page number (1-based). |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pixeljoint-com-api-70ace188/list_artworks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dim":"<string>","dimo":"<string>","keyword":"<string>","page":"<integer>","sort":"<string>"}'
```