Docs menu

Pristine Auction API endpoint

Pristine Auction search API

Browses or searches pristineauction.com's current sports card and memorabilia auction lots. term or category is required, matching pristineauction.com's own search form. All enum values (category, auction_type, sort, status) come from pristine-auction-categories. status=completed browses ended/sold lots (a prices-realized view); the default (all statuses) mirrors the site's own default. Every filter is optional and combines with AND semantics.

GETapiKey3 credits/requestPristine Auctionpristineauction.searchResponseDoc/pristine-auction/search

Endpoint facts

Method: GET
API path: /pristine-auction/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Pristine Auction
Response schema: #/definitions/pristineauction.searchResponseDoc

Pristine Auction Scraper API Try Pristine Auction search API in Playground Pristine Auction API documentation

How this endpoint behaves

Query parameters:

term (optional) — free-text search across lot titles. term or category is required.
category (optional) — one value from pristine-auction-categories' categories[].slug. term or category is required. Allowed values: fine-art, baseball, basketball, boxing-ufc, coins-bullion, comic-books, football, golf, historical, hockey, music, other-sports, pop-culture, racing, soccer, trading-cards, wrestling.
auction_type (optional) — comma-separated auction-type filter. Omit to include every auction type. Allowed values: previous_featured, ten_minute, daily, classic, fine_art, jewelry, pop_culture, tcg, helmet, nascar_foundation, sports_cards, coin, sports_gear, jersey, frame_it_up, fall_showcase, elite, live_stream.
status (optional) — comma-separated auction-status filter. Omit to include every status. Allowed values: future, active, canceled, completed, forfeited. status=completed browses ended/sold lots — a prices-realized view.
sort (optional) — result order, default newly-listed. Allowed values: newly-listed, bid-time-descending, price-descending, price-ascending, ending-soonest, ending-last, bid-count-descending, bid-count-ascending.
min_price (optional) — minimum current bid price in USD, inclusive. Omit or 0 for no minimum.
max_price (optional) — maximum current bid price in USD, inclusive. Omit or 0 for no maximum.
page (optional) — 1-based page number, default 1.
per_page (optional) — results per page. pristineauction.com only accepts 15, 30, or 60; any other value is rejected. Default 30.

Notable response behavior:

total_pages is computed as ceil(total / per_page).
Every filter is optional and combines with AND semantics.
results[].ends_at is the auction's end time, RFC 3339, read from the card's own countdown timestamp.
results[].high_bid is the lot's current bid price in USD (not the realized/sold price, even for a status=completed lot — use pristine-auction-lot-detail's price field for that).
A syntactically valid search that matches nothing returns a well-formed empty result (total: 0, results: []), not an error.

Live monitoring

Monitored request: GET /pristine-auction/search?term=mantle
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 8.24 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /pristine-auction/search?term=mantle
Items in results: 30
Fields filled in every checked item: 10
Fields empty in some or all items: 1

Field	Filled in, of 30 checked	Values in the sample
lot_number	30	13,241,884 to 13,322,553, median 13,266,199
title	30	“1992 Pinnacle Complete Set of (30) Mickey Mantle Baseball C…” and 26 other values
url	30	pristineauction.com
image_url	30	images.pristineauction.com
high_bid	30	3.73 to 3,809.4, median 50
currency	30	USD in all 30
no_reserve	30	true in 14 of 30
auction_type	30	CLASSIC (16), CARD AUCTION (6), ELITE (3) and 3 more
auction_type_url	30	pristineauction.com
ends_at	30	2026-10-14 to 2026-10-26
subtitle	5	“MASSIVE CHASES INCLUDE: $1.7K+ Cooper Flagg PSA Auto, $1.5K…” and 3 other values

Request parameters

Parameter	Type	Required	Description	Example
term	string	No	Free-text search across lot titles. term or category is required.	mantle
category	string	No	One value from pristine-auction-categories' categories[].slug. term or category is required. Allowed values: fine-art, baseball, basketball, boxing-ufc, coins-bullion, comic-books, football, golf, historical, hockey, music, other-sports, pop-culture, racing, soccer, trading-cards, wrestling.	baseball
auction_type	string	No	Comma-separated auction-type filter. Omit to include every auction type. Allowed values: previous_featured, ten_minute, daily, classic, fine_art, jewelry, pop_culture, tcg, helmet, nascar_foundation, sports_cards, coin, sports_gear, jersey, frame_it_up, fall_showcase, elite, live_stream.	daily,classic
status	string	No	Comma-separated auction-status filter. status=completed browses ended/sold lots. Omit to include every status. Allowed values: future, active, canceled, completed, forfeited.	active
sort	string	No	Result order, default newly-listed. Allowed values: newly-listed, bid-time-descending, price-descending, price-ascending, ending-soonest, ending-last, bid-count-descending, bid-count-ascending.	ending-soonest
min_price	number	No	Minimum current bid price in USD, inclusive. Omit or 0 for no minimum.
max_price	number	No	Maximum current bid price in USD, inclusive. Omit or 0 for no maximum.
page	integer	No	1-based page number, default 1
per_page	integer	No	Results per page. pristineauction.com only accepts 15, 30, or 60; any other value is rejected. Default 30. Allowed values: 15, 30, 60.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/pristine-auction/search?category=fine-art&auction_type=previous_featured&status=future&sort=newly-listed&page=1&per_page=15" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "per_page": 30,
    "total": 258,
    "total_pages": 9,
    "results": [
      {
        "lot_number": 13154611,
        "title": "Mickey Mantle 1969 Topps #500 (PSA 8) (MC)",
        "url": "https://www.pristineauction.com/a13154611",
        "image_url": "https://images.pristineauction.com/449/4494947/thumb_1789064410-Mickey-Mantle-1969-Topps-500-PSA-8-MC-PristineAuction.com.jpg",
        "high_bid": 256.66,
        "currency": "USD",
        "no_reserve": true,
        "auction_type": "CARD AUCTION",
        "auction_type_url": "https://www.pristineauction.com/auction/type/sports-cards",
        "ends_at": "2026-09-21T03:00:00Z"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/pristineauction.searchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	pristineauction.SearchResponse	No
data.page	integer	No
data.per_page	integer	No
data.results	array	No
data.results[].auction_type	string	No	CARD AUCTION
data.results[].auction_type_url	string	No
data.results[].currency	string	No	USD
data.results[].ends_at	string	No	2026-09-21T03:00:00Z
data.results[].high_bid	number	No	256.66
data.results[].image_url	string	No
data.results[].lot_number	integer	No	13154611
data.results[].no_reserve	boolean	No
data.results[].subtitle	string	No	Rookie Card
data.results[].title	string	No	Mickey Mantle 1969 Topps #500 (PSA 8) (MC)
data.results[].url	string	No	https://www.pristineauction.com/a13154611
data.total	integer	No
data.total_pages	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/pristine-auction/search?category=fine-art&auction_type=previous_featured&status=future&sort=newly-listed&page=1&per_page=15" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Pristine Auction endpoint docs Pristine Auction Scraper API Pristine Auction categories API documentation Pristine Auction lot detail API documentation

Open in Playground Back to group

Docs menu

Pristine Auction API endpoint

Pristine Auction search API

GETapiKey3 credits/requestPristine Auctionpristineauction.searchResponseDoc/pristine-auction/search

Endpoint facts

Method: GET
API path: /pristine-auction/search
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Pristine Auction
Response schema: #/definitions/pristineauction.searchResponseDoc

Pristine Auction Scraper API Try Pristine Auction search API in Playground Pristine Auction API documentation

How this endpoint behaves

Query parameters:

term (optional) — free-text search across lot titles. term or category is required.
category (optional) — one value from pristine-auction-categories' categories[].slug. term or category is required. Allowed values: fine-art, baseball, basketball, boxing-ufc, coins-bullion, comic-books, football, golf, historical, hockey, music, other-sports, pop-culture, racing, soccer, trading-cards, wrestling.
auction_type (optional) — comma-separated auction-type filter. Omit to include every auction type. Allowed values: previous_featured, ten_minute, daily, classic, fine_art, jewelry, pop_culture, tcg, helmet, nascar_foundation, sports_cards, coin, sports_gear, jersey, frame_it_up, fall_showcase, elite, live_stream.
status (optional) — comma-separated auction-status filter. Omit to include every status. Allowed values: future, active, canceled, completed, forfeited. status=completed browses ended/sold lots — a prices-realized view.
sort (optional) — result order, default newly-listed. Allowed values: newly-listed, bid-time-descending, price-descending, price-ascending, ending-soonest, ending-last, bid-count-descending, bid-count-ascending.
min_price (optional) — minimum current bid price in USD, inclusive. Omit or 0 for no minimum.
max_price (optional) — maximum current bid price in USD, inclusive. Omit or 0 for no maximum.
page (optional) — 1-based page number, default 1.
per_page (optional) — results per page. pristineauction.com only accepts 15, 30, or 60; any other value is rejected. Default 30.

Notable response behavior:

total_pages is computed as ceil(total / per_page).
Every filter is optional and combines with AND semantics.
results[].ends_at is the auction's end time, RFC 3339, read from the card's own countdown timestamp.
results[].high_bid is the lot's current bid price in USD (not the realized/sold price, even for a status=completed lot — use pristine-auction-lot-detail's price field for that).
A syntactically valid search that matches nothing returns a well-formed empty result (total: 0, results: []), not an error.

Live monitoring

Monitored request: GET /pristine-auction/search?term=mantle
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 8.24 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /pristine-auction/search?term=mantle
Items in results: 30
Fields filled in every checked item: 10
Fields empty in some or all items: 1

Field	Filled in, of 30 checked	Values in the sample
lot_number	30	13,241,884 to 13,322,553, median 13,266,199
title	30	“1992 Pinnacle Complete Set of (30) Mickey Mantle Baseball C…” and 26 other values
url	30	pristineauction.com
image_url	30	images.pristineauction.com
high_bid	30	3.73 to 3,809.4, median 50
currency	30	USD in all 30
no_reserve	30	true in 14 of 30
auction_type	30	CLASSIC (16), CARD AUCTION (6), ELITE (3) and 3 more
auction_type_url	30	pristineauction.com
ends_at	30	2026-10-14 to 2026-10-26
subtitle	5	“MASSIVE CHASES INCLUDE: $1.7K+ Cooper Flagg PSA Auto, $1.5K…” and 3 other values

Request parameters

Parameter	Type	Required	Description	Example
term	string	No	Free-text search across lot titles. term or category is required.	mantle
category	string	No	One value from pristine-auction-categories' categories[].slug. term or category is required. Allowed values: fine-art, baseball, basketball, boxing-ufc, coins-bullion, comic-books, football, golf, historical, hockey, music, other-sports, pop-culture, racing, soccer, trading-cards, wrestling.	baseball
auction_type	string	No	Comma-separated auction-type filter. Omit to include every auction type. Allowed values: previous_featured, ten_minute, daily, classic, fine_art, jewelry, pop_culture, tcg, helmet, nascar_foundation, sports_cards, coin, sports_gear, jersey, frame_it_up, fall_showcase, elite, live_stream.	daily,classic
status	string	No	Comma-separated auction-status filter. status=completed browses ended/sold lots. Omit to include every status. Allowed values: future, active, canceled, completed, forfeited.	active
sort	string	No	Result order, default newly-listed. Allowed values: newly-listed, bid-time-descending, price-descending, price-ascending, ending-soonest, ending-last, bid-count-descending, bid-count-ascending.	ending-soonest
min_price	number	No	Minimum current bid price in USD, inclusive. Omit or 0 for no minimum.
max_price	number	No	Maximum current bid price in USD, inclusive. Omit or 0 for no maximum.
page	integer	No	1-based page number, default 1
per_page	integer	No	Results per page. pristineauction.com only accepts 15, 30, or 60; any other value is rejected. Default 30. Allowed values: 15, 30, 60.
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/pristine-auction/search?category=fine-art&auction_type=previous_featured&status=future&sort=newly-listed&page=1&per_page=15" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "page": 1,
    "per_page": 30,
    "total": 258,
    "total_pages": 9,
    "results": [
      {
        "lot_number": 13154611,
        "title": "Mickey Mantle 1969 Topps #500 (PSA 8) (MC)",
        "url": "https://www.pristineauction.com/a13154611",
        "image_url": "https://images.pristineauction.com/449/4494947/thumb_1789064410-Mickey-Mantle-1969-Topps-500-PSA-8-MC-PristineAuction.com.jpg",
        "high_bid": 256.66,
        "currency": "USD",
        "no_reserve": true,
        "auction_type": "CARD AUCTION",
        "auction_type_url": "https://www.pristineauction.com/auction/type/sports-cards",
        "ends_at": "2026-09-21T03:00:00Z"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/pristineauction.searchResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	pristineauction.SearchResponse	No
data.page	integer	No
data.per_page	integer	No
data.results	array	No
data.results[].auction_type	string	No	CARD AUCTION
data.results[].auction_type_url	string	No
data.results[].currency	string	No	USD
data.results[].ends_at	string	No	2026-09-21T03:00:00Z
data.results[].high_bid	number	No	256.66
data.results[].image_url	string	No
data.results[].lot_number	integer	No	13154611
data.results[].no_reserve	boolean	No
data.results[].subtitle	string	No	Rookie Card
data.results[].title	string	No	Mickey Mantle 1969 Topps #500 (PSA 8) (MC)
data.results[].url	string	No	https://www.pristineauction.com/a13154611
data.total	integer	No
data.total_pages	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/pristine-auction/search?category=fine-art&auction_type=previous_featured&status=future&sort=newly-listed&page=1&per_page=15" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Pristine Auction endpoint docs Pristine Auction Scraper API Pristine Auction categories API documentation Pristine Auction lot detail API documentation

Open in Playground Back to group

Pristine Auction 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

Pristine Auction 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