---
title: "Search Goldin's lot auction inventory"
method: GET
path: "/goldin/search"
tags: ["Goldin"]
---

# Search Goldin's lot auction inventory

`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`

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.

## Query parameters

- `auction_type` 'Auction' | 'Fixed_Price'
- `keyword` string
- `category` string
- `sub_category` string
- `certification` string
- `item_type` string
- `auction_id` string
- `sort` 'Featured' | 'Ending_Soonest' | 'Highest_Bids' | 'Lowest_Bids' | 'Most_Bids' | 'Least_Bids' | 'Most_Recent_Bids' | 'Highest_Lot_Number' | 'Recently_Started' | 'Recently_Created'
- `page` integer
- `page_size` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoldinSearchResponseDoc
  - `code` integer
  - `data` GoldinSearchResponse
    - `auction_type` string
    - `lots` GoldinSearchLot[]
      - `allow_offers` boolean: AllowOffers, SoldAt, and FinalPrice are only present for AuctionTypeFixedPrice lots.
      - `auction_id` string
      - `auction_type` string
      - `buyer_premium` number
      - `current_price` integer: CurrentPrice is the current bid (AuctionTypeAuction) or the Buy Now price (AuctionTypeFixedPrice) -- always present regardless of pool.
      - `end_time` string
      - `final_price` integer
      - `image_url` string
      - `lot_id` string
      - `lot_number` integer: LotNumber, MinBidPrice, NumberOfBids, ReserveAmount, StartTime, and EndTime are only present for AuctionTypeAuction lots -- omitted (not just zero) for AuctionTypeFixedPrice, which has no lot numbering, bidding, or auction window.
      - `min_bid_price` integer
      - `number_of_bids` integer
      - `reserve_amount` number
      - `slug` string: Slug is the lot's meta_slug -- pass as slug to goldin-listing for full lot detail.
      - `sold_at` string
      - `start_time` string
      - `status` string
      - `title` string
    - `page` integer
    - `total` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)