Pristine Auction API endpoint
Returns the whole value space for pristine-auction-search's category, auction_type, sort, and status params. categories[] is fetched live (with a current listing count per category, refreshed on every call); auction_types[], sort[], and statuses[] are pristineauction.com's own fixed, small search-form value sets.
/pristine-auction/categoriesPristine Auction's full enum surface for pristine-auction-search:
sport/collectible categories (fetched live, with a current listing count
per category), plus the fixed auction_type, sort, and status enums
the search form accepts.
No query parameters.
Notable response behavior:
categories[] is fetched live from pristineauction.com's own category
select on every call, so count reflects the current live listing
count for that category, not a static snapshot.auction_types[], sort[], and statuses[] are pristineauction.com's
own fixed, small search-form value sets.statuses[].slug values future/active/canceled/completed/
forfeited map to pristine-auction-search's own status filter.
status=completed browses ended/sold lots — a prices-realized view.| Field | Filled in, of 18 checked |
|---|---|
| slug | 18 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/pristine-auction/categories" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"categories": [
{
"slug": "baseball",
"label": "BASEBALL",
"count": 8608,
"url": "https://www.pristineauction.com/auction/category/baseball"
},
{
"slug": "trading-cards",
"label": "TRADING CARDS",
"count": 17836,
"url": "https://www.pristineauction.com/auction/category/trading-cards"
}
],
"auction_types": [
{
"slug": "daily"
},
{
"slug": "classic"
},
{
"slug": "elite"
}
],
"sort": [
{
"slug": "newly-listed"
},
{
"slug": "ending-soonest"
}
],
"statuses": [
{
"slug": "active"
},
{
"slug": "completed"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/pristineauction.categoriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | pristineauction.CategoriesResponse | No | ||||
| data.auction_types | array | No | ||||
| data.auction_types[].slug | string | No | daily | |||
| data.categories | array | No | ||||
| data.categories[].count | integer | No | 8608 | |||
| data.categories[].label | string | No | BASEBALL | |||
| data.categories[].slug | string | No | baseball | |||
| data.categories[].url | string | No | https://www.pristineauction.com/auction/category/baseball | |||
| data.sort | array | No | ||||
| data.sort[].slug | string | No | ending-soonest | |||
| data.statuses | array | No | ||||
| data.statuses[].slug | string | No | completed | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/pristine-auction/categories" \
-H "x-api-key: $CRAWLORA_API_KEY"