Goldin Auctions APIgoldinauctions.com ↗
Search active and sold auction lots on Goldin Auctions. Access bid history, hammer prices, grading info, and lot details via 3 REST endpoints.
What is the Goldin Auctions API?
The Goldin Auctions API provides 3 endpoints for accessing auction lot data from goldinauctions.com, covering active listings, completed sales, and full lot details. The search_lots endpoint lets you filter live auctions by sport, grade, grader, year, and keyword, returning current bid amounts and end dates. The search_sold endpoint surfaces historical hammer prices sorted by sale value, and get_lot returns per-lot bid history, all images, and full metadata.
curl -X GET 'https://api.parse.bot/scraper/55b768f5-0318-4c87-b33c-7270166fd56e/search_lots?query=Michael+Jordan' \ -H 'X-API-Key: $PARSE_API_KEY'
Search active auction lots on Goldin Auctions. Returns paginated results with lot details including current bid, end date, and grading info. Results are ordered by lot number ascending. Each result includes a 'slug' field that can be passed to get_lot for full details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-indexed). Each page returns up to 24 lots. |
| year | string | Filter by card/item year (season). |
| grade | string | Filter by grading certification company (e.g. PSA, Beckett, CGC, SGC, Ungraded). |
| query | string | Search keyword to filter lots (e.g. player name, card set, year). When omitted, returns all active lots. |
| sport | string | Filter by sport/sub-category (e.g. Basketball, Baseball, Football, Hockey, Soccer, Pokemon, Golf, Pop Culture/Entertainment). |
{
"type": "object",
"fields": {
"lots": "array of lot objects with lot_id, slug, title, year, grade, grader, image_url, current_bid, end_date, status",
"page": "current page number",
"total": "total number of matching lots",
"per_page": "results per page (24)"
},
"sample": {
"data": {
"lots": [
{
"set": null,
"slug": "1986-87-fleer-57-michael-jordan-rookie-card-psa-ex-mt-67jhic",
"year": "1986",
"grade": "EX-MT 6",
"title": "1986-87 Fleer #57 Michael Jordan Rookie Card - PSA EX-MT 6",
"grader": "PSA",
"lot_id": "202608-0719-1958-45fbb14e-f9bc-4fa6-b50e-3cc96f050c6c",
"player": null,
"status": "Live",
"end_date": "2026-08-21T02:00:00Z",
"estimate": null,
"image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202608-0719-1958-45fbb14e-f9bc-4fa6-b50e-3cc96f050c6c/9e43251d-7fe9-470c-99af-ab7c5cfa014a@1x",
"current_bid": 5550,
"description": null
}
],
"page": 1,
"total": 156,
"per_page": 24
},
"status": "success"
}
}About the Goldin Auctions API
Active Lots and Sold Results
The search_lots endpoint returns paginated lists of live auction lots — up to 24 per page — with fields including lot_id, slug, title, current_bid, end_date, status, grade, grader, and image_url. You can filter by sport (e.g. Basketball, Pokemon, Pop Culture), grade (e.g. PSA, CGC, SGC, Ungraded), year, or a freeform query keyword. Results are ordered by lot number ascending. The search_sold endpoint mirrors this interface for completed auctions, returning hammer_price and sale_date in place of current_bid and end_date, sorted by highest final price.
Full Lot Detail and Bid History
The get_lot endpoint accepts a lot_id parameter, which corresponds to the slug field returned by either search_lots or search_sold. The response includes the full images array (all lot photos), lot_number, status (Live, Completed_Sold, or Preview), an ISO 8601 end_date, and a bid_history containing the sequence of bids placed on the lot. This makes it possible to reconstruct bidding activity and price progression for any individual item.
Filtering and Pagination
All three endpoints are paginated with a fixed page size of 24. The page parameter is 1-indexed. Filter parameters on search_lots and search_sold are all optional and combinable — you can narrow results to, for example, PSA-graded 1986 Basketball cards matching a specific player name. The total field in each response tells you how many matching records exist across all pages, which is useful for building paginated interfaces or estimating dataset size before iterating.
The Goldin Auctions API is a managed, monitored endpoint for goldinauctions.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when goldinauctions.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 goldinauctions.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 live bid prices on specific sports cards by polling
search_lotswith a player name query - Build a price guide for graded cards by aggregating
hammer_pricedata fromsearch_sold - Monitor auction close times using the
end_datefield to alert on soon-expiring lots - Compare final sale prices across grading tiers (PSA, CGC, SGC) for the same card using
gradeandgraderfilters - Pull full bid histories for individual lots via
get_lotto analyze bidding patterns - Build a collectibles portfolio tracker that maps owned cards to recent Goldin Auctions sale comps
- Research Pokemon and pop culture lot activity by filtering
search_soldwith thesportparameter
| 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 Goldin Auctions have an official developer API?+
What does `get_lot` return that `search_lots` does not?+
get_lot endpoint returns the full images array (all photos, not just the primary), the complete bid_history for the lot, and the lot_number within its auction. The search_lots endpoint returns only the primary image_url and the current top-line bid — enough for listing views but not for deep lot analysis.How does pagination work across the three endpoints?+
page parameter is 1-indexed, and each response includes a total field showing the full count of matching lots. Divide total by 24 and round up to determine the last page. There is no cursor-based pagination; page numbers are the only navigation mechanism.