John Pye Auctions APIjohnpyeauctions.co.uk ↗
Access John Pye Auctions listings via API. Browse by category or search by keyword to retrieve lot numbers, titles, prices, and pagination data.
What is the John Pye Auctions API?
The John Pye Auctions API provides 2 endpoints for retrieving live auction lot data from johnpyeauctions.co.uk. The list_items endpoint returns paginated auction listings for a given category, including lot number, title, price, listing ID, and direct URL. The search_items endpoint adds keyword-based filtering across all categories or within a specific one, returning the same 5-field item objects alongside total page counts.
curl -X GET 'https://api.parse.bot/scraper/b2e1828d-2fbf-4f91-9fbc-5110eeff222f/list_items?page=1&category=C183360492%2FTECH-GAMING' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace johnpyeauctions-co-uk-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: John Pye Auctions SDK — bounded, re-runnable; every call capped."""
from parse_apis.John_Pye_Auctions_API import JohnPyeAuctions, ParseError
client = JohnPyeAuctions()
# Search for laptops across all categories
for item in client.items.search(keyword="laptop", limit=3):
print(item.title, item.price, item.time_remaining, item.ends_at)
# List items in TECH & GAMING category
first_item = client.items.list(category="C183360492/TECH-GAMING", limit=1).first()
try:
print(first_item.listing_id, first_item.title, first_item.price, first_item.ends_at)
except ParseError as e:
print(f"error: {e.code}")
print("exercised: items.search, items.list")
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.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (1-indexed). |
| category | string | Category path segment (e.g. 'C183360492/TECH-GAMING'). Found in the site's Browse URLs. |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"items": "array of auction item objects with listing_id, lot_number, title, price, url, time_remaining, ends_at",
"items_count": "integer - number of items on this page",
"total_pages": "integer - total number of pages available"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"url": "https://www.johnpyeauctions.co.uk/Event/LotDetails/533208633/IPAD-AIR-5TH-GENERATION-WIFI-CELLULAR-64GB-ORIGINAL-RRP-84900",
"price": "£190.00",
"title": "IPAD AIR (5TH GENERATION) WI-FI + CELLULAR 64GB ORIGINAL RRP £849.00",
"listing_id": "533208634",
"lot_number": "5"
}
],
"items_count": 50,
"total_pages": 16
},
"status": "success"
}
}About the John Pye Auctions API
Browsing Auction Categories
The list_items endpoint accepts an optional category parameter formatted as a path segment matching the site's Browse URLs (e.g. C183360492/TECH-GAMING). Omitting the category defaults to the TECH & GAMING section. Each response includes page, total_pages, items_count, and an items array. Each item in the array carries a listing_id, lot_number, title, price, and url. Pagination is 1-indexed via the page parameter.
Keyword Search
The search_items endpoint requires a keyword string (e.g. laptop, printer, sofa) and optionally accepts the same category path segment to scope the search. Leaving category blank searches across all John Pye Auctions categories. The response mirrors the list_items shape — page, total_pages, items_count, and the items array — and also echoes back the keyword used. This makes it straightforward to build paginated keyword-search flows: retrieve total_pages from the first call, then iterate.
Data Coverage and Freshness
All returned price values reflect what is currently listed on the auction page at query time. John Pye Auctions lists returned, ex-display, and liquidation stock across categories such as tech, gaming, furniture, and appliances. The url field in each item points directly to the lot page, allowing downstream lookups without constructing URLs manually. Category slugs must be sourced from the site's Browse URLs and passed as-is to the category parameter.
The John Pye Auctions API is a managed, monitored endpoint for johnpyeauctions.co.uk — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when johnpyeauctions.co.uk changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official johnpyeauctions.co.uk API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor current lot prices in the TECH & GAMING category to identify undervalued items.
- Build a price-tracking tool that pages through
total_pagesresults and logspricechanges over time. - Search for a specific product keyword like 'laptop' across all categories and aggregate
pricedata. - Retrieve
lot_numberandurlvalues to build a deal-alert system for resellers. - Compare auction listing volumes across categories by checking
items_countper category slug. - Automate inventory sourcing by querying
search_itemsfor specific appliance or furniture keywords. - Feed
titleandpricedata into a spreadsheet to track auction pricing trends across multiple pages.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does John Pye Auctions have an official developer API?+
What does the `list_items` endpoint return and how do I navigate pages?+
page integer, an items array (each with listing_id, lot_number, title, price, and url), items_count, and total_pages. Pass the page parameter (1-indexed) to step through results. Combine total_pages from the first response with a loop to retrieve all lots in a category.Can I search within a specific category rather than all listings?+
keyword and a category path segment (e.g. C183360492/TECH-GAMING) to search_items. Omitting category searches all John Pye Auctions categories and returns the same item fields.Does the API return bidding history, bid counts, or auction end times?+
title, price, lot_number, listing_id, and url per item. Bidding history, bid counts, and auction end times are not included in the response. You can fork this API on Parse and revise it to add an endpoint that retrieves additional lot-level detail from the individual listing URL.Are all John Pye Auctions categories accessible, or only TECH & GAMING?+
category parameter in either endpoint. TECH & GAMING (C183360492/TECH-GAMING) is the default for list_items when no category is specified, but it is not the only one supported. Category slugs are taken directly from the site's Browse URL structure.