johnpyeauctions.co.uk APIwww.johnpyeauctions.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.
curl -X GET 'https://api.parse.bot/scraper/b2e1828d-2fbf-4f91-9fbc-5110eeff222f/list_items' \ -H 'X-API-Key: $PARSE_API_KEY'
List auction items from a specific category. Returns paginated results with item title, price, lot number, listing ID, and URL. Default category is TECH & GAMING.
| 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",
"items": "array of auction item objects with listing_id, lot_number, title, price, url",
"items_count": "integer",
"total_pages": "integer"
},
"sample": {
"page": 1,
"items": [
{
"url": "https://www.johnpyeauctions.co.uk/Event/LotDetails/531405420/3-X-MICROSOFT-SURFACE-GO-SIGNATURE-TYPE-COVERS-AND-1-X-MICROSOFT-SURFACE-PRO-KEYBOARD-LOCATION-DR1",
"price": "£38.00",
"title": "3 X MICROSOFT SURFACE GO SIGNATURE TYPE COVERS AND 1 X MICROSOFT SURFACE PRO KEYB...",
"listing_id": "531405421",
"lot_number": "1041"
}
],
"items_count": 50,
"total_pages": 21
}
}About the johnpyeauctions.co.uk 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.
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.
- 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 | 250 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.