invaluable.com APIinvaluable.com ↗
Access auction lot listings, artist profiles, and auction house data from Invaluable.com via 8 endpoints. Search upcoming and past lots, bids, and catalog details.
curl -X GET 'https://api.parse.bot/scraper/03ac36d1-735f-4409-8428-86a450ee4b7a/search_items?page=0&past=false&limit=5&query=painting' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for auction lots with optional filters and pagination. Returns upcoming lots by default, or past/archived lots when past=true.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-based) |
| past | boolean | Search past/archived lots instead of upcoming |
| limit | integer | Results per page |
| query | string | Search keyword |
{
"type": "object",
"fields": {
"page": "integer current page number",
"items": "array of auction lot objects with fields like lotRef, lotTitle, currentBid, houseName, artistName, catalogRef",
"total": "integer total number of matching lots",
"nbPages": "integer total number of pages"
},
"sample": {
"data": {
"page": 0,
"items": [
{
"lotRef": "354E93335E",
"bidCount": 15,
"houseRef": "3DVE2B2O3O",
"lotTitle": "R.C. GORMAN MOTHER AND CHILD, 1970 PASTEL ON PAPER",
"houseName": "Bradford's",
"artistName": "Rudolph Carl Gorman",
"catalogRef": "8DDFG401ZE",
"currentBid": 220,
"currencyCode": "USD",
"currencySymbol": "$",
"supercategoryName": "Decorative Art"
}
],
"total": 40812,
"nbPages": 5000
},
"status": "success"
}
}About the invaluable.com API
The Invaluable.com API provides access to fine art and collectibles auction data through 8 endpoints covering lot search, artist profiles, auction house details, and catalog browsing. The search_items endpoint returns paginated auction lots with fields like lotRef, currentBid, houseName, and artistName, filtering across both upcoming and archived sales. Live bidding fields — currentBidAmount, bidCount, and isClosed — are available per lot via get_item_detail.
Lot Search and Detail
The search_items endpoint accepts a query string, a past boolean to toggle between upcoming and archived lots, and standard page/limit pagination. Each result object includes lotRef, lotTitle, currentBid, houseName, artistName, and catalogRef. Passing past=true switches the result set to closed auctions, making it possible to build price history queries. Individual lot detail is available via get_item_detail, which requires a lotRef and returns live fields including currentBidAmount, bidCount, isClosed, currencyCode, and a text description.
Artists and Auction Houses
list_artists searches the artist database by keyword and returns objects with artistRef, displayName, totalCount, upcomingCount, pastCount, and genres. For most queries all results fit on page 0; pagination beyond that typically returns empty arrays. get_artist_detail accepts an artistRef and returns the same shape. get_upcoming_lots_by_artist accepts an artistRef and returns only lots from upcoming auctions attributed to that artist — past lots are not included in this endpoint.
Auction houses follow the same two-endpoint pattern. list_auction_houses accepts a query and returns objects with houseRef, houseName, and countryName. get_auction_house_detail expands on that with address (street, city, region, country, postalCode), rating, reviewCount, houseLogo, description, and sellerSince.
Catalog Browsing
get_auction_detail accepts a catalogRef (found in search_items results under catalogRef) and returns all lots in that specific auction catalog, paged via page and limit. The endpoint checks both upcoming and archived catalogs, returning whichever set has results. This makes it straightforward to pull a complete lot list for any single sale event.
- Track live bid counts and current bid amounts on specific lots using
get_item_detailfieldscurrentBidAmountandbidCount. - Build a sold-price database for a category by running
search_itemswithpast=trueand storingcurrentBidvalues over time. - List all upcoming lots by a given artist using
get_upcoming_lots_by_artistfiltered byartist_ref. - Profile auction houses by country using
list_auction_houseswith a region query andget_auction_house_detailfor address and rating data. - Reconstruct a full auction catalog — title, bids, artist — by feeding a
catalogRefintoget_auction_detail. - Identify prolific artists in a genre by comparing
totalCountandupcomingCountfields fromlist_artistsresults. - Monitor when a specific lot closes by polling
get_item_detailfor theisClosedboolean.
| 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 Invaluable have an official developer API?+
What does `get_item_detail` return beyond what `search_items` already includes?+
search_items returns summary fields like lotTitle, currentBid, houseName, and artistName. get_item_detail adds live bidding data (currentBidAmount, bidCount, isClosed), the full text description, and explicit currencyCode and currencySymbol fields.Does `get_upcoming_lots_by_artist` also return past/sold lots for an artist?+
past parameter pattern from search_items.Are auction results (hammer prices) available for closed lots?+
currentBidAmount field on get_item_detail reflects the winning bid once isClosed is true. However, there is no dedicated sold-price history endpoint — historical data is only accessible by searching archived lots via search_items with past=true. You can fork the API on Parse and add an endpoint that aggregates past results for a specific lotRef or artist if you need a structured price history feed.How does pagination work for `list_artists`?+
artists array for small result sets, so it is best to check the total field before paginating.