Grailed

Search or browse Grailed active listings

Searches or browses Grailed's (grailed.com) peer-to-peer resale marketplace for currently-active listings. q, designer, department, category, size, color, condition, min_price, and max_price are all optional and combine as an AND -- a free-text q can be combined with any of the facet filters in the same request, or every field can be omitted to browse the full active catalog by Grailed's own "heat" relevance ranking. designer accepts one of the values grailed-designers' own designers[].name field returns; department, category, size, and color accept values from grailed-categories' own departments[].value/categories[].value/sizes[].value/colors[].value fields. condition and sort are fixed, closed enums (listed below). Keyword search uses typo-tolerant relevance ranking, not a guaranteed exact match. A query with genuinely zero matches returns a well-formed empty result rather than an error.

get/grailed/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/grailed/search
  • 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 price (inclusive), in USD

max_pricenumber

Maximum price (inclusive), in USD

sort'heat' | 'heat_recency' | 'followers' | 'newest' | 'price_asc' | 'price_desc' | 'recently_updated' | 'quality'

Sort order, defaults to heat

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.