Goldin

Search Goldin's lot auction inventory

Browse or search Goldin's current lot inventory by free-text keyword, category, sub_category, certification, item_type, and auction_id, in a caller-selected sort order. Every filter is optional and combines with AND semantics. All enum values come from goldin-categories -- pass the matching auction_type to both. The Auction pool (default) and the Fixed Price "Private Sales" marketplace are disjoint item pools with different certification/item_type values and different sort enums.

get/goldin/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/goldin/search
  • Auth: API key in header x-api-key

Query parameters

auction_type'Auction' | 'Fixed_Price'

Auction (default) or Fixed_Price -- selects which lot pool to search

keywordstring

Free-text search across lot titles/descriptions

categorystring

One value from goldin-categories' category field

sub_categorystring

One value from goldin-categories' sub_category field

certificationstring

One value from goldin-categories' certification field

item_typestring

One value from goldin-categories' item_type field

auction_idstring

One auction id from goldin-categories' auctions field -- only meaningful for auction_type Auction

sort'Featured' | 'Ending_Soonest' | 'Highest_Bids' | 'Lowest_Bids' | 'Most_Bids' | 'Least_Bids' | 'Most_Recent_Bids' | 'Highest_Lot_Number' | 'Recently_Started' | 'Recently_Created'

One value from goldin-categories' own sort field for the same auction_type. Auction pool: Featured (default), Ending_Soonest, Highest_Bids, Lowest_Bids, Most_Bids, Least_Bids, Most_Recent_Bids, Highest_Lot_Number, Recently_Started. Fixed Price pool: Recently_Created (default), Highest_Bids, Lowest_Bids

pageinteger

1-based page number, defaults to 1

page_sizeinteger

Page size, defaults to 24, capped at 96

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.