Endpoint Playground

Try the Goldin search API

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.

What a live request returned

14 Oct 2026: 20 lots; 9 fields had a value in every checked item and 2 varied between items.

Observed request: GET /goldin/search?auction_type=Fixed_Price&page_size=20
Fields with a value in every checked item: slug, lot_id, auction_type, title, auction_id, status, current_price, buyer_premium

Sample value profiles: sold_at: 2026-06-16; current_price: 1,500 to 935,000, median 45,000; image_url: d2tt46f3mh26nl.cloudfront.net.

Request: GET /goldin/search
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.59 s
Monitored request: GET /goldin/search?sub_category=Baseball

Goldin search API documentation Goldin platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&sort=Featured' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
auction_type	string	No	Auction	Auction (default) or Fixed_Price -- selects which lot pool to search
keyword	string	No		Free-text search across lot titles/descriptions
category	string	No		One value from goldin-categories' category field
sub_category	string	No		One value from goldin-categories' sub_category field
certification	string	No		One value from goldin-categories' certification field
item_type	string	No		One value from goldin-categories' item_type field
auction_id	string	No		One auction id from goldin-categories' auctions field -- only meaningful for auction_type Auction
sort	string	No	Featured	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
page	integer	No		1-based page number, defaults to 1
page_size	integer	No		Page size, defaults to 24, capped at 96

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "auction_type": "Auction",
    "total": 5540,
    "page": 1,
    "lots": [
      {
        "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys",
        "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6",
        "auction_type": "Weekly",
        "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9",
        "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf",
        "status": "Live",
        "current_price": 13499,
        "buyer_premium": 22,
        "image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x",
        "lot_number": 1000,
        "min_bid_price": 10,
        "number_of_bids": 70,
        "start_time": "2026-09-08T22:00:00Z",
        "end_time": "2026-09-18T02:00:00Z"
      }
    ]
  }
}

More Goldin endpoints

List Goldin's full auction history List Goldin's search filter enums Get one Goldin lot's full public detail Get Goldin's search suggestions for a keyword

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey2 credits/requestgoldin.searchResponseDocGoldin

GET /goldin/search

Search Goldin's lot auction inventory

Response behavior

- Every filter is optional and combines with AND semantics. - A query with genuinely zero matches returns a well-formed empty `lots` array rather than an error. - `slug` in each result is the lot's `meta_slug` — pass it as `slug` to `goldin-listing` for that lot's full detail. - `lot_number`, `min_bid_price`, `number_of_bids`, `reserve_amount`, `start_time`, and `end_time` are only present for `auction_type=Auction` results — omitted entirely for `auction_type=Fixed_Price`, which has no lot numbering, bidding, or auction window. - `allow_offers`, `sold_at`, and `final_price` are only present for `auction_type=Fixed_Price` results. Example response (`auction_type=Auction`, the default): ```json { "code": 200, "msg": "OK", "data": { "auction_type": "Auction", "total": 5540, "page": 1, "lots": [ { "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys", "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6", "auction_type": "Weekly", "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9", "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf", "status": "Live", "current_price": 13499, "buyer_premium": 22.0, "image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x", "lot_number": 1000, "min_bid_price": 10, "number_of_bids": 70, "start_time": "2026-09-08T22:00:00Z", "end_time": "2026-09-18T02:00:00Z" } ] } } ``` Example response (`auction_type=Fixed_Price`): ```json { "code": 200, "msg": "OK", "data": { "auction_type": "Fixed_Price", "total": 148, "page": 1, "lots": [ { "slug": "2020-21-panini-prizm-premier-league-black-prizm-164-heung-min-son-1-1idgya", "lot_id": "202608-2117-4549-629d9881-2adf-452f-8725-8231ba02e701", "auction_type": "Fixed_Price", "title": "2020-21 Panini Prizm Premier League Black Prizm #164 Heung-Min Son (#1/1) - PSA GEM MT 10", "auction_id": "fixed_price_marketplace", "status": "Live", "current_price": 18000, "buyer_premium": 0, "image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202608-2117-4549-629d9881-2adf-452f-8725-8231ba02e701/6b2b18d5-cf5c-4d0e-8faa-7e51de8d1830@1x", "allow_offers": true } ] } } ```

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "auction_type": "Auction",
    "total": 5540,
    "page": 1,
    "lots": [
      {
        "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys",
        "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6",
        "auction_type": "Weekly",
        "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9",
        "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf",
        "status": "Live",
        "current_price": 13499,
        "buyer_premium": 22,
        "image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x",
        "lot_number": 1000,
        "min_bid_price": 10,
        "number_of_bids": 70,
        "start_time": "2026-09-08T22:00:00Z",
        "end_time": "2026-09-18T02:00:00Z"
      }
    ]
  }
}

Try the Goldin search API

What a live request returned

14 Oct 2026: 20 lots; 9 fields had a value in every checked item and 2 varied between items.

Observed request: GET /goldin/search?auction_type=Fixed_Price&page_size=20
Fields with a value in every checked item: slug, lot_id, auction_type, title, auction_id, status, current_price, buyer_premium

Sample value profiles: sold_at: 2026-06-16; current_price: 1,500 to 935,000, median 45,000; image_url: d2tt46f3mh26nl.cloudfront.net.

Request: GET /goldin/search
Cost: 2 credits/request
Auth: apiKey
Checks passed, 7 days to 14 Oct 2026: 100%, median 1.59 s
Monitored request: GET /goldin/search?sub_category=Baseball

Goldin search API documentation Goldin platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&sort=Featured' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
auction_type	string	No	Auction	Auction (default) or Fixed_Price -- selects which lot pool to search
keyword	string	No		Free-text search across lot titles/descriptions
category	string	No		One value from goldin-categories' category field
sub_category	string	No		One value from goldin-categories' sub_category field
certification	string	No		One value from goldin-categories' certification field
item_type	string	No		One value from goldin-categories' item_type field
auction_id	string	No		One auction id from goldin-categories' auctions field -- only meaningful for auction_type Auction
sort	string	No	Featured	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
page	integer	No		1-based page number, defaults to 1
page_size	integer	No		Page size, defaults to 24, capped at 96

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "auction_type": "Auction",
    "total": 5540,
    "page": 1,
    "lots": [
      {
        "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys",
        "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6",
        "auction_type": "Weekly",
        "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9",
        "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf",
        "status": "Live",
        "current_price": 13499,
        "buyer_premium": 22,
        "image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x",
        "lot_number": 1000,
        "min_bid_price": 10,
        "number_of_bids": 70,
        "start_time": "2026-09-08T22:00:00Z",
        "end_time": "2026-09-18T02:00:00Z"
      }
    ]
  }
}

Search Goldin's lot auction inventory

Response behavior

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "auction_type": "Auction", "total": 5540, "page": 1, "lots": [ { "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys", "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6", "auction_type": "Weekly", "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9", "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf", "status": "Live", "current_price": 13499, "buyer_premium": 22, "image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x", "lot_number": 1000, "min_bid_price": 10, "number_of_bids": 70, "start_time": "2026-09-08T22:00:00Z", "end_time": "2026-09-18T02:00:00Z" } ] } }