Endpoint Playground
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.
14 Oct 2026: 24 listings; 23 fields had a value in every checked item and 1 varied between items.
Sample value profiles: sold_at: 2026-10-12 to 2026-10-13; condition: is_used (12), is_gently_used (9), is_new (3); price: 122 to 972, median 182.
curl 'https://api.crawlora.net/api/v1/grailed/sold-listings?department=menswear&condition=is_new&sort=recent' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| q | string | No | Free-text search query | |
| designer | string | No | Designer/brand name filter, from grailed-designers' own designers[].name field | |
| department | string | No | menswear | Department filter |
| category | string | No | Category facet filter, from grailed-categories' own categories[].value field | |
| size | string | No | Size facet filter, from grailed-categories' own sizes[].value field | |
| color | string | No | Color facet filter, from grailed-categories' own colors[].value field | |
| condition | string | No | is_new | Condition filter |
| min_price | number | No | Minimum SOLD price (inclusive), in USD | |
| max_price | number | No | Maximum SOLD price (inclusive), in USD | |
| sort | string | No | recent | Sort order, defaults to recent |
| page | integer | No | One-based page number, defaults to 1 | |
| limit | integer | No | Results per page, defaults to 24, maximum 100 |
{
"code": 200,
"msg": "OK",
"data": {
"query": "gucci",
"sort": "recent",
"page": 1,
"limit": 24,
"count": 1,
"total_results": 4865190,
"total_pages": 202716,
"listings": [
{
"id": 99128590,
"title": "Gucci Flame Sneakers",
"url": "https://www.grailed.com/listings/99128590",
"designers": [
"Gucci"
],
"price": 267,
"currency": "USD",
"sold": true,
"sold_price": 200,
"sold_at": "2026-09-09T15:25:46.880Z",
"condition": "is_used",
"size": "9",
"department": "menswear",
"category": "footwear",
"category_path": "footwear.low_top_sneakers",
"color": "white",
"seller": {
"id": 555,
"username": "sneakerhead",
"total_bought_and_sold": 11,
"trusted_seller": true,
"rating_average": 5,
"rating_count": 4
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.