# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/pixel-joint/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/pixel-joint/get-artwork-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/pixel-joint/list-artworks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"dim":"<string>","dimo":"<string>","keyword":"<string>","page":"<integer>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.