grailed_search
Search and browse active Grailed resale listings by keyword, designer, category, size, color, condition, department, and price range, with sort options.
Instructions
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.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search query | |
| page | No | One-based page number, defaults to 1 | |
| size | No | Size facet filter, from grailed-categories' own sizes[].value field | |
| sort | No | Sort order, defaults to heat | |
| color | No | Color facet filter, from grailed-categories' own colors[].value field | |
| limit | No | Results per page, defaults to 24, maximum 100 | |
| category | No | Category facet filter, from grailed-categories' own categories[].value field | |
| designer | No | Designer/brand name filter, from grailed-designers' own designers[].name field | |
| condition | No | Condition filter | |
| max_price | No | Maximum price (inclusive), in USD | |
| min_price | No | Minimum price (inclusive), in USD | |
| department | No | Department filter |