# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-johnpyeauctions-co-uk-api-0a5d9f7d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-johnpyeauctions-co-uk-api-0a5d9f7d/list_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-johnpyeauctions-co-uk-api-0a5d9f7d/search_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","keyword":"<string>","page":"<integer>"}'
```