Grailed

Search Grailed sold listings (sale price history)

Searches Grailed's SOLD-listing index -- a separate dataset from active listings, carrying each item's final sale price and sale date. Same filter shape as grailed-search (q, designer, department, category, size, color, condition), but min_price/max_price filter the SOLD price, not the original asking price. Useful for sale-price-history/comparable-sales lookups (e.g. "what did this designer/category actually sell for recently"). A query with genuinely zero matches returns a well-formed empty result rather than an error.

get/grailed/sold-listings

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/grailed/sold-listings
  • Auth: API key in header x-api-key

Query parameters

qstring

Free-text search query

designerstring

Designer/brand name filter, from grailed-designers' own designers[].name field

department'menswear' | 'womenswear'

Department filter

categorystring

Category facet filter, from grailed-categories' own categories[].value field

sizestring

Size facet filter, from grailed-categories' own sizes[].value field

colorstring

Color facet filter, from grailed-categories' own colors[].value field

condition'is_new' | 'is_gently_used' | 'is_used' | 'is_worn' | 'is_not_specified'

Condition filter

min_pricenumber

Minimum SOLD price (inclusive), in USD

max_pricenumber

Maximum SOLD price (inclusive), in USD

sort'recent' | 'price_asc' | 'price_desc'

Sort order, defaults to recent

pageinteger

One-based page number, defaults to 1

limitinteger

Results per page, defaults to 24, maximum 100

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.