Docs menu

Goldin API endpoint

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.

GETapiKey2 credits/requestGoldingoldin.searchResponseDoc/goldin/search

Endpoint facts

Method: GET
API path: /goldin/search
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Goldin
Response schema: #/definitions/goldin.searchResponseDoc

Goldin Scraper API Try Goldin search API in Playground Goldin API documentation

How this endpoint behaves

Query parameters:

auction_type (optional) — Auction (default) or Fixed_Price. Selects which of Goldin's two disjoint lot pools to search: the live-bidding Auction pool, or the Fixed Price "Private Sales" Buy Now marketplace. Use the matching goldin-categories call (same auction_type) to discover valid filter/sort values for the pool you're searching.
keyword (optional) — free-text search across lot titles/descriptions.
category (optional) — one value from goldin-categories' own category field, e.g. Sport.
sub_category (optional) — one value from goldin-categories' own sub_category field, e.g. Baseball.
certification (optional) — one value from goldin-categories' own certification field, e.g. PSA.
item_type (optional) — one value from goldin-categories' own item_type field, e.g. Single Cards.
auction_id (optional) — one auction id from goldin-categories' own auctions field, scoping results to a single auction event. Only meaningful for auction_type=Auction — the Fixed Price pool has a single constant pseudo-auction id.
sort (optional) — 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 (optional) — 1-based page number, defaults to 1.
page_size (optional) — defaults to 24, capped at 96.

Notable 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):

{
  "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):

{
  "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
      }
    ]
  }
}

Live monitoring

Monitored request: GET /goldin/search?sub_category=Baseball
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.59 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /goldin/search?auction_type=Fixed_Price&page_size=20
Items in lots: 20
Fields filled in every checked item: 9
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
slug	20
lot_id	20
auction_type	20	Fixed_Price in all 20
title	20	median 121 characters
auction_id	20
status	20	Live in all 20
current_price	20	1,500 to 935,000, median 45,000
buyer_premium	20	0 to 11.11, median 0
image_url	20	d2tt46f3mh26nl.cloudfront.net
allow_offers	19	true in 19 of 19
sold_at	1	2026-06-16

Request parameters

Parameter	Type	Required	Default	Description	Example
auction_type	string	No		Auction (default) or Fixed_Price -- selects which lot pool to search Allowed values: Auction, Fixed_Price.
keyword	string	No		Free-text search across lot titles/descriptions
category	string	No		One value from goldin-categories' category field	Sport
sub_category	string	No		One value from goldin-categories' sub_category field	Baseball
certification	string	No		One value from goldin-categories' certification field	PSA
item_type	string	No		One value from goldin-categories' item_type field	Single Cards
auction_id	string	No		One auction id from goldin-categories' auctions field -- only meaningful for auction_type Auction
sort	string	No		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 Allowed values: Featured, Ending_Soonest, Highest_Bids, Lowest_Bids, Most_Bids, Least_Bids, Most_Recent_Bids, Highest_Lot_Number, Recently_Started, Recently_Created.
page	integer	No	1	1-based page number, defaults to 1
page_size	integer	No	24	Page size, defaults to 24, capped at 96
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&keyword=coffee&sort=Featured&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goldin.searchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	goldin.SearchResponse	No
data.auction_type	string	No
data.lots	array	No
data.lots[].allow_offers	boolean	No		AllowOffers, SoldAt, and FinalPrice are only present for AuctionTypeFixedPrice lots.
data.lots[].auction_id	string	No
data.lots[].auction_type	string	No
data.lots[].buyer_premium	number	No
data.lots[].current_price	integer	No		CurrentPrice is the current bid (AuctionTypeAuction) or the Buy Now price (AuctionTypeFixedPrice) -- always present regardless of pool.
data.lots[].end_time	string	No
data.lots[].final_price	integer	No
data.lots[].image_url	string	No
data.lots[].lot_id	string	No
data.lots[].lot_number	integer	No		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.
data.lots[].min_bid_price	integer	No
data.lots[].number_of_bids	integer	No
data.lots[].reserve_amount	number	No
data.lots[].slug	string	No		Slug is the lot's meta_slug -- pass as slug to goldin-listing for full lot detail.
data.lots[].sold_at	string	No
data.lots[].start_time	string	No
data.lots[].status	string	No
data.lots[].title	string	No
data.page	integer	No
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&keyword=coffee&sort=Featured&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Goldin endpoint docs Goldin Scraper API Goldin auctions API documentation Goldin categories API documentation Goldin listing API documentation Goldin suggest API documentation

Open in Playground Back to group

Docs menu

Goldin API endpoint

Goldin search API

GETapiKey2 credits/requestGoldingoldin.searchResponseDoc/goldin/search

Endpoint facts

Method: GET
API path: /goldin/search
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Goldin
Response schema: #/definitions/goldin.searchResponseDoc

Goldin Scraper API Try Goldin search API in Playground Goldin API documentation

How this endpoint behaves

Query parameters:

auction_type (optional) — Auction (default) or Fixed_Price. Selects which of Goldin's two disjoint lot pools to search: the live-bidding Auction pool, or the Fixed Price "Private Sales" Buy Now marketplace. Use the matching goldin-categories call (same auction_type) to discover valid filter/sort values for the pool you're searching.
keyword (optional) — free-text search across lot titles/descriptions.
category (optional) — one value from goldin-categories' own category field, e.g. Sport.
sub_category (optional) — one value from goldin-categories' own sub_category field, e.g. Baseball.
certification (optional) — one value from goldin-categories' own certification field, e.g. PSA.
item_type (optional) — one value from goldin-categories' own item_type field, e.g. Single Cards.
auction_id (optional) — one auction id from goldin-categories' own auctions field, scoping results to a single auction event. Only meaningful for auction_type=Auction — the Fixed Price pool has a single constant pseudo-auction id.
sort (optional) — 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 (optional) — 1-based page number, defaults to 1.
page_size (optional) — defaults to 24, capped at 96.

Notable 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):

{
  "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):

{
  "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
      }
    ]
  }
}

Live monitoring

Monitored request: GET /goldin/search?sub_category=Baseball
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.59 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /goldin/search?auction_type=Fixed_Price&page_size=20
Items in lots: 20
Fields filled in every checked item: 9
Fields empty in some or all items: 2

Field	Filled in, of 20 checked	Values in the sample
slug	20
lot_id	20
auction_type	20	Fixed_Price in all 20
title	20	median 121 characters
auction_id	20
status	20	Live in all 20
current_price	20	1,500 to 935,000, median 45,000
buyer_premium	20	0 to 11.11, median 0
image_url	20	d2tt46f3mh26nl.cloudfront.net
allow_offers	19	true in 19 of 19
sold_at	1	2026-06-16

Request parameters

Parameter	Type	Required	Default	Description	Example
auction_type	string	No		Auction (default) or Fixed_Price -- selects which lot pool to search Allowed values: Auction, Fixed_Price.
keyword	string	No		Free-text search across lot titles/descriptions
category	string	No		One value from goldin-categories' category field	Sport
sub_category	string	No		One value from goldin-categories' sub_category field	Baseball
certification	string	No		One value from goldin-categories' certification field	PSA
item_type	string	No		One value from goldin-categories' item_type field	Single Cards
auction_id	string	No		One auction id from goldin-categories' auctions field -- only meaningful for auction_type Auction
sort	string	No		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 Allowed values: Featured, Ending_Soonest, Highest_Bids, Lowest_Bids, Most_Bids, Least_Bids, Most_Recent_Bids, Highest_Lot_Number, Recently_Started, Recently_Created.
page	integer	No	1	1-based page number, defaults to 1
page_size	integer	No	24	Page size, defaults to 24, capped at 96
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&keyword=coffee&sort=Featured&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

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"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/goldin.searchResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	goldin.SearchResponse	No
data.auction_type	string	No
data.lots	array	No
data.lots[].allow_offers	boolean	No		AllowOffers, SoldAt, and FinalPrice are only present for AuctionTypeFixedPrice lots.
data.lots[].auction_id	string	No
data.lots[].auction_type	string	No
data.lots[].buyer_premium	number	No
data.lots[].current_price	integer	No		CurrentPrice is the current bid (AuctionTypeAuction) or the Buy Now price (AuctionTypeFixedPrice) -- always present regardless of pool.
data.lots[].end_time	string	No
data.lots[].final_price	integer	No
data.lots[].image_url	string	No
data.lots[].lot_id	string	No
data.lots[].lot_number	integer	No		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.
data.lots[].min_bid_price	integer	No
data.lots[].number_of_bids	integer	No
data.lots[].reserve_amount	number	No
data.lots[].slug	string	No		Slug is the lot's meta_slug -- pass as slug to goldin-listing for full lot detail.
data.lots[].sold_at	string	No
data.lots[].start_time	string	No
data.lots[].status	string	No
data.lots[].title	string	No
data.page	integer	No
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
500	Internal Server Error	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/goldin/search?auction_type=Auction&keyword=coffee&sort=Featured&page=1" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Goldin endpoint docs Goldin Scraper API Goldin auctions API documentation Goldin categories API documentation Goldin listing API documentation Goldin suggest API documentation

Open in Playground Back to group

Goldin search API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Goldin search API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related