Clean Sweep Auctions APImarketplace.cleansweepauctions.com ↗
Search active, completed, and fixed-price lots on Clean Sweep Auctions. Get bid counts, next-bid amounts, grades, and sale prices via 2 endpoints.
What is the Clean Sweep Auctions API?
The Clean Sweep Auctions Marketplace API gives programmatic access to auction and fixed-price listings across the site's three listing pools using 2 endpoints. The search_lots endpoint accepts keyword queries and a status filter to target active auctions, recently closed lots, or store inventory, returning up to 20 results per page with pagination support. The get_lot endpoint delivers per-lot economics including current bid amount, bid count, grade, grader, and listing status.
curl -X GET 'https://api.parse.bot/scraper/64d6f3af-b59f-4ce7-a4f1-7c938dd39538/search_lots?sort=price&query=mantle&status=active' \ -H 'X-API-Key: $PARSE_API_KEY'
Keyword search over the marketplace listings. One round trip per call; results are returned in pages of 20 lots (page 1 when page is omitted) and has_more says whether a further page exists. The status filter selects one of three independent listing pools the site exposes: active auction lots (default), recently closed auction lots, or fixed-price online-store listings; the pools are never mixed. Each row carries the site's own lot id, lot number (auction lots only; null for store items), title, URL, listing status as displayed (active, ended, or fixed_price), and only the money figures the listing page shows: current_bid and next_bid for auction lots (for ended lots this is the last bid shown, not a final sale price), asking_price for fixed-price items. currency is USD when the site displays a $ figure for the row, otherwise null. Grading fields are read from the title text only: condition_text is the raw text after 'Cond:' when present; grader, grade and grade_qualifier are filled only when a recognised grading company code (PSA, SGC, BGS, BVG, BCCG, CSG, CGC, GAI, KSA, HGA, TAG, ISA, ACE, MNT) with a numeric or A/AA/Auth grade appears, and grade_qualifier only when an explicit PSA/SGC qualifier (MC, OC, ST, MK, PD, OF) follows the grade. Nothing is inferred: missing values are null. Optional sort accepts the site's own sort codes. A query with no matches is a valid empty result (lots is an empty array).
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page number; each page holds up to 20 lots. Omitted = first page. |
| sort | string | Result ordering, using the site's sort options. |
| queryrequired | string | Keyword(s) to search for in listing titles/descriptions; all keywords must match. |
| status | string | Which listing pool to search: active auction lots, completed (recently closed) auction lots, or fixed_price online-store listings. |
{
"type": "object",
"fields": {
"lots": "array of lot rows: lot_id (string, site item id), lot_number (string or null), title, url, listing_type (auction|fixed_price), status (active|ended|fixed_price), current_bid, next_bid, asking_price (numbers or null), currency (USD or null), time_remaining_text (site countdown text, active auction lots only), condition_text, grader, grade, grade_qualifier (strings or null)",
"page": "1-based page number returned",
"query": "echo of the search keywords",
"has_more": "boolean: true when a further page of results exists",
"page_size": "maximum lots per page (20)",
"status_filter": "the listing pool searched (active, completed, fixed_price)"
},
"sample": {
"data": {
"lots": [
{
"url": "https://marketplace.cleansweepauctions.com/item-902361/",
"grade": "7",
"title": "Lot #447 1958 Topps # 418 Mantle/Aaron Cond: PSA 7",
"grader": "PSA",
"lot_id": "902361",
"status": "active",
"currency": "USD",
"next_bid": 660,
"lot_number": "447",
"current_bid": 600,
"asking_price": null,
"listing_type": "auction",
"condition_text": "PSA 7",
"grade_qualifier": null,
"time_remaining_text": "Ends in 14d 12h 7m +"
}
],
"page": 1,
"query": "mantle",
"has_more": true,
"page_size": 20,
"status_filter": "active"
},
"status": "success"
}
}About the Clean Sweep Auctions API
What the API Covers
The API exposes Clean Sweep Auctions' marketplace inventory through two endpoints. search_lots accepts a required query string and an optional status parameter that selects one of three independent listing pools: active (open auctions), completed (recently closed auctions), or fixed_price (store listings). Results arrive in pages of 20 lots, each row carrying lot_id, lot_number, title, url, listing_type, and status metadata. The has_more boolean tells you whether a subsequent page exists, and the page parameter lets you step through results.
Lot Detail Fields
get_lot accepts either the numeric lot_id or the full lot URL as emitted by search_lots. The response includes the lot's identity fields (lot_id, inventory_id, lot_number, title, url), its status (active, ended, or fixed_price), and pricing data. For auction lots, next_bid carries the next valid bid amount (null once bidding closes) and bid_count reports the number of bids placed. Where the site prints a grade, grade and grader are populated; both are null when no grading information is present. listed_at provides an ISO-8601 timestamp with UTC offset when available, and currency is set to USD whenever dollar figures appear.
Pagination and Filtering
Every search_lots call targets exactly one listing pool per request — there is no single call that spans all three pools simultaneously. Page 1 is returned when the page parameter is omitted. The optional sort parameter maps to the ordering options the site exposes natively. Because page_size is fixed at 20, iterating large result sets requires sequential page increments guided by has_more.
The Clean Sweep Auctions API is a managed, monitored endpoint for marketplace.cleansweepauctions.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when marketplace.cleansweepauctions.com 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 marketplace.cleansweepauctions.com 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?+
- Track bid counts and next-bid prices on active Clean Sweep auction lots for a price-alert tool
- Pull recently closed lot prices via the
completedstatus filter to build a realized-price database for collectibles - Compare fixed-price store listings against auction closing prices using
listing_typefrom search results - Aggregate graded card or collectible data using the
gradeandgraderfields returned byget_lot - Monitor new listings for specific keywords by polling
search_lotswithstatus=activeand checkinglisted_attimestamps - Build a lot-watching dashboard that alerts when
statuschanges from active to ended on trackedlot_idvalues
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Clean Sweep Auctions have an official developer API?+
What does `search_lots` return for completed auctions, and how is that different from active lots?+
status is set to completed, search_lots searches the recently closed auction pool and returns the same row shape — lot_id, title, url, listing_type, and status metadata — as active searches. The get_lot call on a completed lot will show status: ended, a null next_bid (since bidding is closed), and a bid_count reflecting final bid activity. Active lots return a live next_bid amount as long as the auction is open.Does the API return seller information or buyer details for lots?+
next_bid, bid_count), grading fields, listing timestamps, and status. Seller profiles and buyer details are not part of the response shape. You can fork this API on Parse and revise it to add a seller-detail endpoint if that data is accessible on the lot page.Can I search across all three listing pools in a single API call?+
search_lots call targets exactly one pool (active, completed, or fixed_price). Covering all three requires three separate requests. You can fork this API on Parse and revise it to add a combined endpoint that fans out and merges results from all pools.Are bid history or individual bidder records available through `get_lot`?+
get_lot returns the aggregate bid_count and the current next_bid amount, but individual bid records and bidder identities are not included. You can fork this API on Parse and revise it to add a bid-history endpoint if that data is exposed on the lot's detail page.