Wheatland Auction Services APIwheatlandauctionservices.com ↗
Access sports card and memorabilia lot data from Wheatland Auction Services. Search lots by keyword or category, retrieve bids, grades, and estimates.
What is the Wheatland Auction Services API?
The Wheatland Auction Services API exposes two endpoints covering the current online auction catalog at wheatlandauctionservices.com: search_lots returns paginated lot cards with inventory IDs, titles, grading details, status, and minimum bid data, while get_lot returns a full detail record for a single lot including bid count, pre-sale estimate, condition text, and category breadcrumb. Both endpoints return structured data for sports cards and memorabilia lots denominated in USD.
curl -X GET 'https://api.parse.bot/scraper/490cfa77-9d76-4f88-be84-8720e42d8ca8/search_lots?query=Namath' \ -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 wheatlandauctionservices-com-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: Wheatland Auction Services — browse lots and drill into detail."""
from parse_apis.wheatlandauctionservices_com_api import (
WheatlandAuction, Sort, Category, LotStatus, LotNotFound,
)
client = WheatlandAuction()
# Browse football lots sorted by price descending, capped at 5 results.
for lot_summary in client.lot_summaries.search(
category=Category.FOOTBALL, sort=Sort.PRICE_DESC, limit=5,
):
print(lot_summary.title, lot_summary.final_price_incl_premium)
# Search for a specific card, take the first hit, then fetch full detail.
hit = client.lot_summaries.search(query="Namath", limit=1).first()
if hit is not None:
lot = hit.details()
print(lot.title, lot.condition, lot.description)
print("Estimate:", lot.estimate.low, "-", lot.estimate.high, lot.currency)
if lot.grading.grader:
print("Graded by", lot.grading.grader, "at", lot.grading.grade)
print("Hammer:", lot.hammer_price, "Final:", lot.final_price_incl_premium)
print("Categories:", " > ".join(lot.category_path))
# Point lookup by inventory_id discovered from the search above.
if hit is not None:
try:
detail = client.lots.get(inventory_id=hit.inventory_id)
print(detail.title, detail.bid_count, "bids")
except LotNotFound:
print("Lot no longer available")
print("exercised: lot_summaries.search / details / lots.get")
Returns one page (fixed 20 lots) of the current auction's lot cards, optionally keyword-searched, category-browsed and sorted. Each row carries the site's native numeric inventory_id (use it with get_lot), lot number, title, URL, grading parsed only when a grader and grade are explicitly printed in the title (otherwise null), a status derived from the card ('completed' when the card prints a final price, otherwise 'active'), and separate price roles: minimum_bid (the printed minimum/opening bid), current_bid (only printed on open lots; null on closed ones), and final_price_incl_premium (printed only after closing; includes the buyer's premium per the auction banner). All amounts are USD under the auctioneer's Terms clause 3. A closed card is not evidence that the lot sold; no sold flag is emitted. The page parameter walks the site's sequential Next control, so page N costs N round trips; has_more is true when the site offers a further page. status filters the fetched page locally, so page_lot_count (unfiltered count) can exceed len(lots). A keyword search covers the whole auction; the site drops the category filter when a query is present, so category only applies to browsing with an empty query. A query with no matches returns an empty lots array.
| Param | Type | Description |
|---|---|---|
| page | integer | 1-based page of 20 lots, maximum 25. |
| sort | string | Result ordering, applied by the site. |
| query | string | Keyword searched in the field named by search_field. Empty browses the whole auction (or the chosen category). |
| status | string | Keep only lots in this state on the fetched page. Omitted = no filtering. |
| category | string | Numeric category code from the site's category dropdown; 1 is all categories. Ignored when query is non-empty. Unknown codes are passed to the site, which returns the unfiltered catalog. |
| search_field | string | Which lot field the query is matched against. |
{
"type": "object",
"fields": {
"lots": "array of lot cards: inventory_id (string, native site id), lot_number, title, url, grading{grader,grade}, status, currency, minimum_bid, current_bid, final_price_incl_premium, bid_count, estimate{low,high}",
"page": "requested page number",
"query": "echo of the keyword used",
"has_more": "true when the site offers a next page",
"page_size": "fixed page size (20)",
"auction_name": "name of the auction whose catalog is shown",
"status_filter": "the status filter applied locally, or null",
"page_lot_count": "number of lots the site returned on this page before status filtering",
"auction_message": "the site's catalog banner (e.g. closing notice and premium note); null when absent"
},
"sample": {
"data": {
"lots": [
{
"url": "https://wheatlandauctionservices.com/mobile/LotDetail.aspx?inventoryid=36659",
"title": "High-Quality 1965 Topps Joe Namath Rookie Card #122 Graded CGC 6",
"status": "completed",
"grading": {
"grade": 6,
"grader": "CGC"
},
"currency": "USD",
"estimate": {
"low": 3500,
"high": 6500
},
"bid_count": 16,
"lot_number": "1",
"current_bid": null,
"minimum_bid": 5,
"inventory_id": "36659",
"final_price_incl_premium": 5015
}
],
"page": 1,
"query": "Namath",
"has_more": false,
"page_size": 20,
"auction_name": "August 2026 Sports Card & Memorabilia Auction",
"status_filter": "completed",
"page_lot_count": 10,
"auction_message": "Auction closed on 8/23/2026. Final prices include buyers premium."
},
"status": "success"
}
}About the Wheatland Auction Services API
Searching and Browsing Lots
search_lots returns a fixed page of 20 lot cards from the current auction catalog. You can supply a query string to keyword-search lots and select which field is matched via search_field. When no query is provided, the category parameter accepts the site's numeric category codes (1 returns all categories) to browse a specific segment of the auction. Results can be ordered with the sort parameter and further narrowed client-side with status filtering. The response includes has_more to indicate additional pages (up to page 25), auction_name, auction_message (the catalog banner, such as closing notices and buyer's premium notes), and page_lot_count showing how many lots were on the page before any status filter was applied.
Lot Detail Records
get_lot takes a single required input — inventory_id, a numeric string emitted by search_lots — and returns a structured record for that lot. The response includes lot_number, title, url, status (active or completed), current_bid (null when bidding has closed), bid_count, estimate (low and high pre-sale figures), condition (printed condition grade text), and grading (an object with grader and grade fields, populated only when explicit third-party grading appears in the title). The category field returns the breadcrumb path as shown on the site.
Grading and Currency Notes
Grading data in both endpoints is parsed only when a recognized third-party grader and grade are explicitly present in the lot title; otherwise both grader and grade fields are null. All monetary values across the API are USD, per the auction's stated terms. The condition field in get_lot reflects printed condition text from the lot description and is separate from the structured grading object.
The Wheatland Auction Services API is a managed, monitored endpoint for wheatlandauctionservices.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wheatlandauctionservices.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 wheatlandauctionservices.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?+
- Monitor active lot prices in real time by polling
get_lotforcurrent_bidandbid_countupdates. - Build a category-filtered lot browser using
search_lotswith numericcategorycodes andsortordering. - Aggregate pre-sale estimate ranges from
estimate.lowandestimate.highacross multiple lots for market research. - Extract graded card lots by filtering
search_lotsresults wheregrading.graderandgrading.gradeare non-null. - Track lot status transitions from active to completed by comparing
statusvalues across repeated calls. - Compile a full auction catalog by paginating
search_lotsacross up to 25 pages and resolving eachinventory_idwithget_lot. - Capture closing notices and buyer's premium details from the
auction_messagefield insearch_lots.
| 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 Wheatland Auction Services offer an official developer API?+
What does `get_lot` return that `search_lots` does not?+
get_lot returns fields not available in the lot card: bid_count, the estimate object (low and high pre-sale figures), condition text from the description, the full category breadcrumb path, and a description field with the lot's full text. The current_bid field in get_lot is also null when bidding has closed, clearly signaling a completed lot.Does the API cover historical or past auction results?+
How does pagination work in `search_lots`, and are there limits?+
has_more field indicates whether additional pages exist, and you can request up to page 25 (500 lots total). The page_lot_count field shows how many lots the source returned on that page before any status filter you specified was applied locally.Can I retrieve individual bidder identities or bid histories through the API?+
bid_count (total bids placed) and current_bid (the current high bid) for each lot. You can fork this API on Parse and revise it to target any bid-history detail the site makes available.