Endpoint Playground
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.
14 Oct 2026: 24 listings; 21 fields had a value in every checked item and 1 varied between items.
Sample value profiles: created_at: 2026-10-11 to 2026-10-13; condition: is_used (10), is_gently_used (8), is_new (6); price: 60 to 1,200, median 218.
curl 'https://api.crawlora.net/api/v1/grailed/search?department=menswear&condition=is_new&sort=heat' \
-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 price (inclusive), in USD | |
| max_price | number | No | Maximum price (inclusive), in USD | |
| sort | string | No | heat | Sort order, defaults to heat |
| 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": "heat",
"page": 1,
"limit": 24,
"count": 1,
"total_results": 250601,
"total_pages": 10442,
"listings": [
{
"id": 105379689,
"title": "Chateau Marmont Gucci Tshirt Red Japan Exclusive",
"url": "https://www.grailed.com/listings/105379689",
"designers": [
"Gucci"
],
"price": 400,
"currency": "USD",
"sold": false,
"condition": "is_gently_used",
"size": "m",
"department": "menswear",
"category": "tops",
"category_path": "tops.short_sleeve_shirts",
"color": "black",
"location": "United States",
"cover_photo_url": "https://media-assets.grailed.com/prd/listing/temp/dc6e1242b28a48bba80b5a353bb8c869",
"photo_count": 7,
"follower_count": 712,
"buy_now": true,
"make_offer": true,
"seller": {
"id": 10332947,
"username": "woodlandstepps",
"total_bought_and_sold": 52,
"trusted_seller": false,
"rating_average": 4.78,
"rating_count": 9
}
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.