# John Pye Auctions — 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 live auction listings from John Pye Auctions and search for specific items to find current titles and prices. Easily navigate through multiple pages of results to discover available lots and compare pricing.

**Category:** Marketplaces | **Website:** [www.johnpyeauctions.co.uk/Browse/C183360492/TECH-GAMING](https://www.johnpyeauctions.co.uk/Browse/C183360492/TECH-GAMING) | **Docs:** [parse.bot/marketplace/0a5d9f7d-53f7-44e0-adc4-ba8c06886f9e/johnpyeauctions-co-uk-api](https://parse.bot/marketplace/0a5d9f7d-53f7-44e0-adc4-ba8c06886f9e/johnpyeauctions-co-uk-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/john-pye-auctions/`
**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

### List items

List auction items from a specific category. Returns paginated results with item title, price, lot number, listing ID, URL, time remaining, and end time. Default category is TECH & GAMING. Each page returns up to 50 items. Use the total_pages field to know how many pages are available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path segment (e.g. 'C183360492/TECH-GAMING'). Found in the site's Browse URLs. |
| `page` | integer | No | Page number (1-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/john-pye-auctions/list-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### Search items

Search auction items by keyword, optionally filtered to a specific category. Returns paginated results with item title, price, lot number, listing ID, URL, time remaining, and end time. Searches across all categories by default. Each page returns up to 50 items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category path segment to search within (e.g. 'C183360492/TECH-GAMING'). Omitting searches all categories. |
| `keyword` | string | Yes | Search keyword (e.g. 'laptop', 'printer', 'sofa'). |
| `page` | integer | No | Page number (1-indexed). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/john-pye-auctions/search-items \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","keyword":"<string>","page":"<integer>"}'
```

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