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.
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
Free-text search query
Designer/brand name filter, from grailed-designers' own designers[].name field
Department filter
Category facet filter, from grailed-categories' own categories[].value field
Size facet filter, from grailed-categories' own sizes[].value field
Color facet filter, from grailed-categories' own colors[].value field
Condition filter
Minimum price (inclusive), in USD
Maximum price (inclusive), in USD
Sort order, defaults to heat
One-based page number, defaults to 1
Results per page, defaults to 24, maximum 100
Headers
API key required
Response
OK
Example response
{
"code": 200,
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.