Docs menu

Goldin API endpoint

Goldin listing API

One lot's full public detail: title, description, current bid/starting price, auction window and status, grading info, images, and prev/next lot pointers within the same auction. slug is the meta_slug from a goldin-search result (or the trailing path segment of the lot's own goldin.co/item/{slug} page URL).

GETapiKey2 credits/requestGoldingoldin.listingResponseDoc/goldin/listing

Endpoint facts

Method: GET
API path: /goldin/listing
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Goldin
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/goldin.listingResponseDoc

Goldin Scraper API Try Goldin listing API in Playground Goldin API documentation

How this endpoint behaves

Query parameters:

slug (required) — the lot's meta_slug, from a goldin-search result's own slug field (or the trailing path segment of the lot's own goldin.co/item/{slug} page URL).

Notable response behavior:

description is plain text — Goldin's own HTML description is stripped of markup.
grading_company is present only for graded items (e.g. PSA); it is not the same enum as goldin-search's certification filter, which also includes non-grader values like Ungraded and Multiple.
images are full URLs, ready to fetch directly.
previous_lot/next_lot are omitted when there is no neighboring lot (e.g. the first or last lot in an auction).
allow_offers, sold_at, and final_price are only present when auction_type is Fixed_Price (a lot from Goldin's Buy Now marketplace — see goldin-search's auction_type parameter).
A slug Goldin cannot resolve returns 404.

Live monitoring

Monitored request: GET /goldin/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /goldin/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys
Fields returned with a value: 25

Field	In the sample	Value in the sample
slug	Has a value
lot_id	Has a value
lot_number	Has a value	1,000
title	Has a value	107 characters
description	Has a value	1,298 characters
auction_id	Has a value
auction_name	Has a value	“2026 Weekly Auction Sep 8 - Sep 17”
auction_type	Has a value	“Weekly”
status	Has a value	“Completed_Sold”
current_price	Has a value	27,000
min_bid_price	Has a value	10
buyer_premium	Has a value	22
number_of_bids	Has a value	78
number_of_views	Has a value	10,558
category	Has a value	“Sport”
sub_category	Has a value	“Basketball”
item_type	Has a value	“Single Cards”
grading_company	Has a value	“PSA”
serial_number	Has a value	“SF0000341944”
start_time	Has a value	2026-09-08
end_time	Has a value	2026-09-18
images	Has a value	2 entries
next_lot.slug	Has a value
next_lot.lot_number	Has a value	1,001
final_price	Has a value	27,000

Request parameters

Parameter	Type	Required	Default	Description	Example
slug	string	Yes		The lot's meta_slug, from a goldin-search result	2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goldin/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys",
    "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6",
    "lot_number": 1000,
    "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9",
    "description": "Graded MINT 9 by PSA (171523823). Hall of Famer. Only one higher-graded example of this piece has been confirmed in PSA's census reporting...",
    "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf",
    "auction_name": "2026 Weekly Auction Sep 8 - Sep 17",
    "auction_type": "Weekly",
    "status": "Live",
    "current_price": 13499,
    "min_bid_price": 10,
    "buyer_premium": 22,
    "number_of_bids": 70,
    "number_of_views": 2366,
    "category": "Sport",
    "sub_category": "Basketball",
    "item_type": "Single Cards",
    "grading_company": "PSA",
    "serial_number": "SF0000341944",
    "start_time": "2026-09-08T22:00:00Z",
    "end_time": "2026-09-18T02:00:00Z",
    "images": [
      "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x"
    ],
    "next_lot": {
      "slug": "2025-topps-chrome-chrome-legends-autograph-black-geometric-cla-tb-tomuw9hh",
      "lot_number": 1001
    },
    "source_url": "https://goldin.co/item/2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys"
  }
}

Request schema

No body schema

Response schema

#/definitions/goldin.listingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	goldin.ListingResult	No
data.allow_offers	boolean	No		AllowOffers, SoldAt, and FinalPrice are only present for AuctionType "Fixed_Price" lots (Goldin's Buy Now marketplace).
data.auction_id	string	No
data.auction_name	string	No
data.auction_type	string	No
data.buyer_premium	number	No
data.category	string	No
data.current_price	integer	No
data.description	string	No
data.end_time	string	No
data.final_price	integer	No
data.grading_company	string	No		GradingCompany is the third-party grader, e.g. "PSA" -- present only for graded items. Not the same enum as Search's certification filter, which also includes "Ungraded".
data.images	array	No
data.item_type	string	No
data.lot_id	string	No
data.lot_number	integer	No
data.min_bid_price	integer	No
data.next_lot	goldin.ListingLotRef	No
data.next_lot.lot_number	integer	No
data.next_lot.slug	string	No
data.number_of_bids	integer	No
data.number_of_views	integer	No
data.previous_lot	goldin.ListingLotRef	No
data.previous_lot.lot_number	integer	No
data.previous_lot.slug	string	No
data.reserve_amount	number	No
data.serial_number	string	No
data.slug	string	No
data.sold_at	string	No
data.source_url	string	No
data.start_time	string	No
data.status	string	No
data.sub_category	string	No
data.title	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/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/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys" \
  -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 search API documentation Goldin suggest API documentation

Open in Playground Back to group

Docs menu

Goldin API endpoint

Goldin listing API

GETapiKey2 credits/requestGoldingoldin.listingResponseDoc/goldin/listing

Endpoint facts

Method: GET
API path: /goldin/listing
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Goldin
Execution: Managed browser rendering where the target needs it
Response schema: #/definitions/goldin.listingResponseDoc

Goldin Scraper API Try Goldin listing API in Playground Goldin API documentation

How this endpoint behaves

Query parameters:

slug (required) — the lot's meta_slug, from a goldin-search result's own slug field (or the trailing path segment of the lot's own goldin.co/item/{slug} page URL).

Notable response behavior:

description is plain text — Goldin's own HTML description is stripped of markup.
grading_company is present only for graded items (e.g. PSA); it is not the same enum as goldin-search's certification filter, which also includes non-grader values like Ungraded and Multiple.
images are full URLs, ready to fetch directly.
previous_lot/next_lot are omitted when there is no neighboring lot (e.g. the first or last lot in an auction).
allow_offers, sold_at, and final_price are only present when auction_type is Fixed_Price (a lot from Goldin's Buy Now marketplace — see goldin-search's auction_type parameter).
A slug Goldin cannot resolve returns 404.

Live monitoring

Monitored request: GET /goldin/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 1.60 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /goldin/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys
Fields returned with a value: 25

Field	In the sample	Value in the sample
slug	Has a value
lot_id	Has a value
lot_number	Has a value	1,000
title	Has a value	107 characters
description	Has a value	1,298 characters
auction_id	Has a value
auction_name	Has a value	“2026 Weekly Auction Sep 8 - Sep 17”
auction_type	Has a value	“Weekly”
status	Has a value	“Completed_Sold”
current_price	Has a value	27,000
min_bid_price	Has a value	10
buyer_premium	Has a value	22
number_of_bids	Has a value	78
number_of_views	Has a value	10,558
category	Has a value	“Sport”
sub_category	Has a value	“Basketball”
item_type	Has a value	“Single Cards”
grading_company	Has a value	“PSA”
serial_number	Has a value	“SF0000341944”
start_time	Has a value	2026-09-08
end_time	Has a value	2026-09-18
images	Has a value	2 entries
next_lot.slug	Has a value
next_lot.lot_number	Has a value	1,001
final_price	Has a value	27,000

Request parameters

Parameter	Type	Required	Default	Description	Example
slug	string	Yes		The lot's meta_slug, from a goldin-search result	2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/goldin/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "slug": "2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys",
    "lot_id": "202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6",
    "lot_number": 1000,
    "title": "2001-02 Upper Deck MJ Tributes MJ Milestones Autograph #M2 Michael Jordan Signed Card (#09/30) - PSA MINT 9",
    "description": "Graded MINT 9 by PSA (171523823). Hall of Famer. Only one higher-graded example of this piece has been confirmed in PSA's census reporting...",
    "auction_id": "202603-0419-1022-71116570-6a20-4d1b-9fe7-100b3a3e50bf",
    "auction_name": "2026 Weekly Auction Sep 8 - Sep 17",
    "auction_type": "Weekly",
    "status": "Live",
    "current_price": 13499,
    "min_bid_price": 10,
    "buyer_premium": 22,
    "number_of_bids": 70,
    "number_of_views": 2366,
    "category": "Sport",
    "sub_category": "Basketball",
    "item_type": "Single Cards",
    "grading_company": "PSA",
    "serial_number": "SF0000341944",
    "start_time": "2026-09-08T22:00:00Z",
    "end_time": "2026-09-18T02:00:00Z",
    "images": [
      "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202607-2220-5302-10dbdf1f-31ef-4e7c-838c-979dd41926c6/deb34feb-964d-4146-887e-ee7825e43183@1x"
    ],
    "next_lot": {
      "slug": "2025-topps-chrome-chrome-legends-autograph-black-geometric-cla-tb-tomuw9hh",
      "lot_number": 1001
    },
    "source_url": "https://goldin.co/item/2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys"
  }
}

Request schema

No body schema

Response schema

#/definitions/goldin.listingResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	goldin.ListingResult	No
data.allow_offers	boolean	No		AllowOffers, SoldAt, and FinalPrice are only present for AuctionType "Fixed_Price" lots (Goldin's Buy Now marketplace).
data.auction_id	string	No
data.auction_name	string	No
data.auction_type	string	No
data.buyer_premium	number	No
data.category	string	No
data.current_price	integer	No
data.description	string	No
data.end_time	string	No
data.final_price	integer	No
data.grading_company	string	No		GradingCompany is the third-party grader, e.g. "PSA" -- present only for graded items. Not the same enum as Search's certification filter, which also includes "Ungraded".
data.images	array	No
data.item_type	string	No
data.lot_id	string	No
data.lot_number	integer	No
data.min_bid_price	integer	No
data.next_lot	goldin.ListingLotRef	No
data.next_lot.lot_number	integer	No
data.next_lot.slug	string	No
data.number_of_bids	integer	No
data.number_of_views	integer	No
data.previous_lot	goldin.ListingLotRef	No
data.previous_lot.lot_number	integer	No
data.previous_lot.slug	string	No
data.reserve_amount	number	No
data.serial_number	string	No
data.slug	string	No
data.sold_at	string	No
data.source_url	string	No
data.start_time	string	No
data.status	string	No
data.sub_category	string	No
data.title	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/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/listing?slug=2002-03-upper-deck-mj-tribute-michael-jordan-milestones-m2-michael-jor1lwys" \
  -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 search API documentation Goldin suggest API documentation

Open in Playground Back to group

Goldin listing 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 listing 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