Grailed: Search
Search from Grailed as JSON. 1 credit per successful call.
GET /v1/grailed/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
query | string | Optional | Up to 100 characters |
designer[] | list of string | Optional | Up to 80 characters |
category[] | list of string | Optional | Any |
department | string | Optional | menswear, womenswear |
size[] | list of string | Optional | Any |
condition[] | list of string | Optional | new, gently_used, used, worn |
price_min | integer | Optional | Any |
price_max | integer | Optional | Any |
location[] | list of string | Optional | United States, Canada, United Kingdom, Europe, Asia, Australia/NZ, Other |
status | string | Optional | for_sale, sold |
sort | string | Optional | relevance, newest, price_asc, price_desc, heat, heat_recency, most_liked, quality |
page | integer | Optional | Any |
Example request
Grailed
GET/v1/grailed/search?query=undercover+jacket&designer[]=Undercover&price_max=1500&sort=newest
{
"success": true,
"items": [
{
"id": 112096050,
"url": "https://www.grailed.com/listings/112096050",
"title": "Sz 2 Undercover 15AW Ghost Hand Coat mojos13491027",
"designers": [
{
"id": 10,
"name": "Undercover"
}
],
"category": "outerwear",
"category_path": "outerwear.heavy_coats",
"department": "menswear",
"size": "m",
"color": "black",
"condition": {
"key": "is_gently_used",
"label": "Gently Used"
},
"price": {
"amount": 1299,
"currency": "USD"
},
"pricing": {
"price_drop_count": 0
},
"sold": false,
"location": "Asia",
"shipping": {
"us": {
"amount": 60,
"enabled": true
},
"ca": {
"amount": 60,
"enabled": true
},
"uk": {
"amount": 60,
"enabled": true
},
"eu": {
"amount": 60,
"enabled": false
},
"asia": {
"amount": 60,
"enabled": true
},
"au": {
"amount": 60,
"enabled": true
},
"other": {
"amount": 60,
"enabled": true
}
},
"cover_photo": {
"url": "https://media-assets.grailed.com/prd/listing/temp/5c6024caf66c44eb83fe4388d7930adc",
"width": 1206,
"height": 1608
},
"photo_count": 7,
"measurement_count": 0,
"likes": 0,
"buy_now": true,
"make_offer": true,
"market": "grailed",
"traits": [
{
"name": "color",
"value": "black"
},
{
"name": "country_of_origin",
"value": "JP"
}
],
"seller": {
"id": 319028,
"username": "MOJOs",
"avatar_url": "https://media-assets.grailed.com/prd/avatar/319028/254106e53f5641188f6ae801f47caf12",
"rating": {
"average": 4.91,
"count": 488
},
"items_bought_and_sold": 1369,
"trusted_seller": true
},
"created_at": "2026-11-12T11:14:32.574Z",
"bumped_at": "2026-11-12T11:14:24.537Z",
"price_updated_at": "2026-11-12T11:14:32.574Z"
},
{
"id": 112094581,
"url": "https://www.grailed.com/listings/112094581",
"title": "Vintage Japanese Brand DAILY TOPICS Chore Denim Jacket",
"designers": [
{
"id": 431,
"name": "Comme des Garcons"
},
{
"id": 10,
"name": "Undercover"
}
],
"category": "outerwear",
"category_path": "outerwear.denim_jackets",
"department": "menswear",
"size": "m",
"color": "blue",
"condition": {
"key": "is_gently_used",
"label": "Gently Used"
},
"price": {
"amount": 199,
"currency": "USD"
},
"pricing": {
"price_drop_count": 0
},
"sold": false,
"location": "Asia",
"shipping": {
"us": {
"amount": 25,
"enabled": true
},
"ca": {
"amount": 25,
"enabled": true
},
"uk": {
"amount": 25,
"enabled": true
},
"eu": {
"amount": 25,
"enabled": true
},
"asia": {
"amount": 25,
"enabled": true
},
"au": {
"amount": 25,
"enabled": true
},
"other": {
"amount": 25,
"enabled": true
}
},
"cover_photo": {
"url": "https://media-assets.grailed.com/prd/listing/29548583/d6f2f53e4fc446c1af094f526e809694",
"width": 3024,
"height": 4032
},
"photo_count": 14,
"measurement_count": 4,
"likes": 6,
"buy_now": true,
"make_offer": true,
"market": "grailed",
"styles": [
"avant-garde"
],
"traits": [
{
"name": "color",
"value": "blue"
},
{
"name": "country_of_origin",
"value": "JP"
}
],
"seller": {
"id": 892097,
"username": "OneLegend",
"avatar_url": "https://media-assets.grailed.com/prd/avatar/892097/06ccd3a054544df295b5cec5dbaded72",
"rating": {
"average": 4.8,
"count": 1001
},
"items_bought_and_sold": 2619,
"trusted_seller": false
},
"created_at": "2026-11-12T10:44:22.218Z",
"bumped_at": "2026-11-12T10:44:22.218Z",
"price_updated_at": "2026-11-12T10:44:22.218Z"
},
{
"id": 112083095,
"url": "https://www.grailed.com/listings/112083095",
"title": "AW16 Jacket",
"designers": [
{
"id": 10,
"name": "Undercover"
}
],
"category": "outerwear",
"category_path": "outerwear.heavy_coats",
"department": "menswear",
"size": "l",
"color": "blue",
"condition": {
"key": "is_gently_used",
"label": "Gently Used"
},
"price": {
"amount": 375,
"currency": "USD"
},
"pricing": {
"price_drop_count": 0
},
"sold": false,
"location": "Asia",
"shipping": {
"us": {
"amount": 30,
"enabled": true
},
"ca": {
"amount": 30,
"enabled": true
},
"uk": {
"amount": 35,
"enabled": true
},
"eu": {
"amount": 35,
"enabled": true
},
"asia": {
"amount": 35,
"enabled": true
},
"au": {
"amount": 35,
"enabled": true
},
"other": {
"amount": 40,
"enabled": true
}
},
"cover_photo": {
"url": "https://media-assets.grailed.com/prd/listing/temp/224de82f396d404a90e7035e6ea2ddbb",
"width": 900,
"height": 1200
},
"photo_count": 8,
"measurement_count": 4,
"likes": 0,
"buy_now": true,
"make_offer": true,
"market": "grailed",
"traits": [
{
"name": "color",
"value": "blue"
}
],
"seller": {
"id": 8645176,
"username": "pony_express",
"avatar_url": "https://media-assets.grailed.com/prd/avatar/8645176/0eb92ddfe7d647f49f726e4695360e6c",
"rating": {
"average": 4.95,
"count": 679
},
"items_bought_and_sold": 1927,
"trusted_seller": true
},
"created_at": "2026-11-12T07:20:47.451Z",
"bumped_at": "2026-11-12T07:20:37.145Z",
"price_updated_at": "2026-11-12T07:20:47.451Z"
}
],
"pagination": {
"page": 1,
"per_page": 40,
"total_results": 5060,
"reachable_results": 1000,
"total_pages": 25,
"has_more": true
},
"filters_applied": {
"query": "undercover jacket",
"price_max": "1500",
"sort": "newest",
"designer": [
"Undercover"
],
"status": "for_sale"
},
"meta": {
"endpoint_family": "search",
"filtered_out": 0,
"request_id": "req_de3338db23e34ae2abd3eb34dc3ea922",
"credits_charged": 1,
"credits_remaining": 1919
}
}200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.