Wheatland Auction Services APIwheatlandauctionservices.com ↗
Search and retrieve sports card and memorabilia auction lots and fixed-price store items from Wheatland Auction Services via 4 structured endpoints.
What is the Wheatland Auction Services API?
The Wheatland Auction Services API provides 4 endpoints covering the site's current online auction catalog and fixed-price store. Use search_lots to paginate, filter, and keyword-search active auction lots returning fields like inventory_id, current_bid, bid_count, grading, and estimate, then call get_lot with any inventory_id to retrieve full lot detail. A parallel pair of endpoints — search_store and get_store_item — covers the site's Website Exclusive Catalog of fixed-price sports cards and memorabilia.
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, drill into detail, and search the store."""
from parse_apis.wheatlandauctionservices_com_api import (
WheatlandAuction, Sort, Category, 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")
# Browse the fixed-price store catalog, take one hit, and fetch its detail.
store_hit = client.store_item_summaries.search(limit=1).first()
if store_hit is not None:
item = store_hit.details()
print(item.title, item.asking_price, item.currency_symbol)
print("Categories:", " > ".join(item.category_path))
print("exercised: lot_summaries.search / details / lots.get / store_item_summaries.search / store_items.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
Auction Lot Search and Detail
search_lots returns pages of up to 20 lots from the current Wheatland auction. You can pass a query string and a search_field to restrict keyword matching, supply a numeric category code to browse a subset of the catalog, and apply a sort to control ordering. The response includes an auction_name, an auction_message banner (closing notices, buyer premium notes), and a has_more flag for pagination up to page 25. Each lot card in lots carries an inventory_id, lot_number, title, url, status, currency, and a grading object — {grader, grade} — populated only when explicit third-party grading appears in the title. A local status filter lets you keep only lots in a specific state from the fetched page. Pass any inventory_id to get_lot to retrieve the full record: current_bid, bid_count, estimate (low/high), condition text, category breadcrumb path, description, and status (active or completed).
Fixed-Price Store Catalog
search_store pages through the site's Website Exclusive Catalog. You can supply a query and search_field, set limit (1–20 items per page), and paginate up to page 25. The response includes a store_name heading, a category_summary count string (the site's own "All (N)" label), and a has_more flag. Each item in items carries an item_id, title, url, asking_price as a number, currency_symbol, and the same grading object pattern as auction lots.
Store Item Detail
get_store_item takes an item_id from search_store and returns the full item record: asking_price, currency_symbol, description, category_path (breadcrumb array from broadest to narrowest), image_count, and add_to_cart_offered — a boolean indicating whether the page renders a purchase control. The grading object follows the same rule: both fields are null unless explicit third-party grading is present in the title. All endpoints are anonymous and read-only; no account credentials are required.
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
current_bidandbid_countchanges across lots to track auction activity in the current Wheatland sale. - Filter
search_lotsbycategorycode and sort to build a ranked list of graded cards for a specific sport or set. - Use
get_lotestimatefields to compare pre-sale estimates againstcurrent_bidfor valuation research. - Scan
search_storefor fixed-price items whereadd_to_cart_offeredis true to identify immediately purchasable inventory. - Parse the
gradingobject acrosssearch_lotsresults to aggregate available PSA- or BGS-graded lots in one auction. - Track
auction_messagebanners fromsearch_lotsto detect closing-day notices and buyer premium updates. - Cross-reference
asking_pricefromget_store_itemwith auction hammer prices to evaluate buy-now vs. bid trade-offs.
| 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 present on lot cards: description text, condition grade text, a category breadcrumb path, a pre-sale estimate object with low and high values, bid_count, and the auction_name. search_lots lot cards include minimum bid and status but omit the description and estimate detail that only appear on the individual lot page.Is historical auction data or past hammer prices available?+
search_lots, get_lot) and the fixed-price store (search_store, get_store_item). Lots show status as completed once bidding closes, but realized prices from prior sales are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting Wheatland's past auction archive pages.How does pagination work and are there limits?+
search_lots is fixed at 20 lots per page and accepts a 1-based page parameter up to a maximum of 25. The has_more field in the response indicates whether a next page exists. search_store supports a configurable limit of 1–20 items per page, also paginated up to page 25, with its own has_more flag.