Goldin API endpoint
Goldin's full filter-enum surface for goldin-search, scoped to one lot pool -- category, sub_category, certification, item_type, and the live auction list (each with its own id, name, and current lot count), plus the sort enum valid for that pool. category/sub_category/certification/item_type are read live from Goldin's own current inventory, not a fixed taxonomy, so results can shift over time. 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 -- pass the same auction_type here and to goldin-search.
/goldin/categoriesQuery parameters:
auction_type (optional) — Auction (default) or Fixed_Price.
Selects which of Goldin's two disjoint lot pools to discover enums for.
The live-bidding Auction pool and the Fixed Price "Private Sales" Buy
Now marketplace carry different certification/item_type values and
different sort enums — pass the same auction_type here and to
goldin-search.Notable response behavior:
category, sub_category, certification, and item_type are read
live from Goldin's own current inventory, not a fixed taxonomy — the
exact set of values can shift over time as new lots are listed, and
differs between the two pools (e.g. WATA, AFA, and VGA
certifications and item types like VHS and Betamax and
Carded Figures exist only under auction_type=Fixed_Price).sort for auction_type=Auction (default): Featured (default —
despite its UI label "Lowest Lot #"), Ending_Soonest, Highest_Bids,
Lowest_Bids, Most_Bids, Least_Bids, Most_Recent_Bids,
Highest_Lot_Number, Recently_Started.sort for auction_type=Fixed_Price: Recently_Created (default),
Highest_Bids, Lowest_Bids — a smaller, non-overlapping enum, since
fixed-price listings have no lot number or bid count to sort by.Example response (auction_type=Auction, the default):
{
"code": 200,
"msg": "OK",
"data": {
"auction_type": "Auction",
"category": ["Sport", "Non-Sport", "Oscar Alley Collection"],
"sub_category": ["Baseball", "Basketball", "Football"],
"certification": ["PSA", "Ungraded", "Beckett", "Other", "CGC", "SGC", "AMG", "JSA", "Multiple"],
"item_type": ["Single Cards", "Memorabilia", "Cases/Boxes/Packs"],
"auctions": [
{ "id": "202605-0515-1956-e34eb08d-dad8-4f5d-8e0e-23494bffa363", "name": "2026 Monthly Sports Elite #8", "lot_count": 1519 }
],
"sort": ["Featured", "Ending_Soonest", "Highest_Bids", "Lowest_Bids", "Most_Bids", "Least_Bids", "Most_Recent_Bids", "Highest_Lot_Number", "Recently_Started"]
}
}
Example response (auction_type=Fixed_Price):
{
"code": 200,
"msg": "OK",
"data": {
"auction_type": "Fixed_Price",
"category": ["Non-Sport", "Sport"],
"sub_category": ["Pop Culture/Entertainment", "Baseball", "Basketball"],
"certification": ["Ungraded", "Other", "PSA", "CGC", "WATA", "AMG", "AFA", "Beckett", "Multiple", "VGA"],
"item_type": ["Art", "Video Games", "Music", "Single Cards", "Toys", "VHS and Betamax"],
"auctions": [
{ "id": "fixed_price_marketplace", "name": "Marketplace", "lot_count": 148 }
],
"sort": ["Recently_Created", "Highest_Bids", "Lowest_Bids"]
}
}
| Field | In the sample | Value in the sample |
|---|---|---|
| auction_type | Has a value | “Fixed_Price” |
| category | Has a value | 3 entries |
| sub_category | Has a value | 20 entries |
| certification | Has a value | 10 entries |
| item_type | Has a value | 16 entries |
| auctions | Has a value | 1 entry |
| sort | Has a value | 3 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| auction_type | string | No | Auction (default) or Fixed_Price -- selects which lot pool to discover enums for Allowed values: Auction, Fixed_Price. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/goldin/categories?auction_type=Auction" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"auction_type": "Auction",
"category": [
"Sport",
"Non-Sport",
"Oscar Alley Collection"
],
"sub_category": [
"Baseball",
"Basketball",
"Football"
],
"certification": [
"PSA",
"Ungraded",
"Beckett",
"Other",
"CGC",
"SGC",
"AMG",
"JSA",
"Multiple"
],
"item_type": [
"Single Cards",
"Memorabilia",
"Cases/Boxes/Packs"
],
"auctions": [
{
"id": "202605-0515-1956-e34eb08d-dad8-4f5d-8e0e-23494bffa363",
"name": "2026 Monthly Sports Elite #8",
"lot_count": 1519
}
],
"sort": [
"Featured",
"Ending_Soonest",
"Highest_Bids",
"Lowest_Bids",
"Most_Bids",
"Least_Bids",
"Most_Recent_Bids",
"Highest_Lot_Number",
"Recently_Started"
]
}
}Request schema
No body schema
Response schema
#/definitions/goldin.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | goldin.CategoriesResponse | No | ||||
| data.auction_type | string | No | ||||
| data.auctions | array | No | ||||
| data.auctions[].id | string | No | ID is Goldin's own auction id -- pass as auction_id to Search. | |||
| data.auctions[].lot_count | integer | No | LotCount is how many lots currently carry this auction id, read live from the same facets response. | |||
| data.auctions[].name | string | No | Name is Goldin's own auction title, e.g. "2026 Weekly Auction Sep 8 - Sep 17". | |||
| data.category | array | No | ||||
| data.certification | array | No | ||||
| data.item_type | array | No | ||||
| data.sort | array | No | ||||
| data.sub_category | array | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/goldin/categories?auction_type=Auction" \
-H "x-api-key: $CRAWLORA_API_KEY"