Grailed listing search
GET https://api.api.sh/grailed/v1/search
Search Grailed listings (menswear and womenswear resale) with every filter of the shop: keywords, department, category, subcategory, size, designer (name or id), condition, color, seller location, market (strata), badge and price range, in eight sort orders. sold=true searches sold listings instead and returns each one's sold price and sold date (sorts: recently sold, price low or high). Each listing: id, title, link, designers, price (USD), sold price and date, size, condition, department, category, color, styles, location, buy now and offer flags, price drops, follower count, badges, cover image, dates and the seller's public username, rating and transaction count, plus raw. Also returns the facet values with counts for the search. Pass next_page back as page; null on the last page (the site shows the first 1,000 results of a search).
Every response includes credits_used: the credits this call cost.
Part of the Grailed API: 12 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
q | string | Keywords (designer, item, model). Optional when a filter is set. Example: rick owens geobasket |
sold | boolean | true searches sold listings (sold price and date in each item). Example: false |
sort | default | relevance | newest | popular | trending | most_followed | price_asc | price_desc | recently_sold | Order: default (recently listed or bumped), relevance, newest, popular, trending, most_followed, price_asc, price_desc. With sold=true: default/recently_sold, price_asc, price_desc. |
department | menswear | womenswear | Department. |
category | string | Top category, e.g. tops, bottoms, outerwear, footwear, tailoring, accessories (comma list = any of). Values in facets.category. |
subcategory | string | Category path, e.g. footwear.hitop_sneakers or tops.sweatshirts_hoodies (comma list). Values in facets.category_path or /grailed/v1/categories. |
size | string | Category size, e.g. tops.m, bottoms.32, footwear.10 (comma list). Values in facets.category_size. |
designer | string | Designer name as Grailed spells it, e.g. Rick Owens (comma list). Values in facets["designers.name"]. |
designer_id | string | Designer id, e.g. 32 (comma list), from /grailed/v1/designers. |
condition | string | is_new, is_gently_used, is_used, is_worn, is_not_specified (comma list). |
color | string | Color, e.g. black, blue (comma list). |
location | string | Seller location: United States, Europe, Asia, Canada, United Kingdom, Australia/NZ, Other (comma list). |
strata | string | Market: grailed, hype, sartorial, basic (comma list). |
badge | string | Badge, e.g. staff_pick. |
price_min | number | Lowest price in USD. |
price_max | number | Highest price in USD. |
limit | integer | Results per page, 1-100 (default 40). |
page | integer | Page number (default 1). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/grailed/v1/search?q=rick+owens+geobasket&sold=false" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/grailed/v1/search",
params={"q": "rick owens geobasket", "sold": "false"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/grailed/v1/search");
url.searchParams.set("q", "rick owens geobasket");
url.searchParams.set("sold", "false");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"query": "rick owens geobasket","sold": false,"sort": "default","page": 1,"limit": 40,"total_results": 1108,"total_pages": 25,"next_page": 2,"count": 40,"listings": [{"id": 87590043,"title": "Geobasket","url": "https://www.grailed.com/listings/87590043","designers": [{"id": 32,"name": "Rick Owens","slug": null}],"designer_names": "Rick Owens","price": 630,"currency": "USD","sold": false,"sold_price": null,"sold_at": null,"sold_shipping_price": null,"size": "10","pretty_size": null,"condition": "is_new","condition_label": "New","department": "menswear","category": "footwear","category_path": "footwear.leather","color": "pink","styles": ["streetwear"],"strata": "grailed","location": "Europe","buy_now": false,"make_offer": true,"dropped": true,"price_drops": [700,630],"followers": 213,"badges": [],"image": "https://media-assets.grailed.com/prd/listing/temp/2b5f363ad3d4496c804dc0f2f46cfbff","created_at": "2025-11-16T16:20:21.986Z","bumped_at": "2025-11-16T15:47:52.816Z","price_updated_at": "2025-11-23T17:00:08.156Z","seller": {"id": 17895683,"username": "Albertoma68","url": "https://www.grailed.com/Albertoma68","avatar": "https://media-assets.grailed.com/prd/avatar/17895683/dbb2577f74de43f7bbad8c8b93ddb332","location": null,"country_code": null,"joined_at": null,"total_transactions": 0,"rating_average": null,"rating_count": 0,"sold_count": null,"purchase_count": null,"review_tags": null,"listings_for_sale": null,"followers": null,"following": null,"trusted_seller": false,"verified": null,"quick_responder": null,"speedy_shipper": null,"power_seller_group": null,"on_vacation": null}},{"id": 107160962,"title": "Rick Owen’s jumbolace geobasket RU02E1898 LWNW2","url": "https://www.grailed.com/listings/107160962","designers": [{"id": 32,"name": "Rick Owens","slug": null}],"designer_names": "Rick Owens","price": 1377,"currency": "USD","sold": false,"sold_price": null,"sold_at": null,"sold_shipping_price": null,"size": "15","pretty_size": null,"condition": "is_new","condition_label": "New","department": "menswear","category": "footwear","category_path": "footwear.hitop_sneakers","color": "brown","styles": [],"strata": "grailed","location": "Europe","buy_now": true,"make_offer": true,"dropped": true,"price_drops": [1700,1530,"… 1 more"],"followers": 11,"badges": [],"image": "https://media-assets.grailed.com/prd/listing/temp/8c24990144724f949d001074939ba340","created_at": "2026-09-28T19:18:27.554Z","bumped_at": "2026-10-15T10:11:33.325Z","price_updated_at": "2026-11-06T08:15:24.510Z","seller": {"id": 9383846,"username": "r_nikkkkk","url": "https://www.grailed.com/r_nikkkkk","avatar": "https://media-assets.grailed.com/prd/avatar/9383846/63d83623e7d14629a38f21d82c4c366f","location": null,"country_code": null,"joined_at": null,"total_transactions": 45,"rating_average": 4.833333333333333,"rating_count": 24,"sold_count": null,"purchase_count": null,"review_tags": null,"listings_for_sale": null,"followers": null,"following": null,"trusted_seller": false,"verified": null,"quick_responder": null,"speedy_shipper": null,"power_seller_group": null,"on_vacation": null}},"… 38 more"],"facets": {"color": {"black": 554,"white": 131,"multi": 96,"brown": 76,"gray": 64,"beige": 53,"green": 31,"orange": 26,"pink": 26,"silver": 13,"yellow": 13,"purple": 10,"blue": 7,"red": 6,"gold": 2},"strata": {"grailed": 1107,"hype": 1},"category": {"footwear": 908,"womens_footwear": 200},"location": {"Asia": 546,"United States": 301,"Europe": 156,"Canada": 54,"Other": 32,"Australia/NZ": 10,"United Kingdom": 9},"condition": {"is_gently_used": 693,"is_new": 266,"is_used": 138,"is_worn": 11},"department": {"menswear": 908,"womenswear": 200},"category_path": {"footwear.hitop_sneakers": 731,"womens_footwear.hitop_sneakers": 168,"footwear.boots": 107,"footwear.lowtop_sneakers": 60,"womens_footwear.lowtop_sneakers": 20,"footwear.leather": 8,"womens_footwear.boots": 7,"womens_footwear.flats": 4,"footwear.sandals": 2,"womens_footwear.platforms": 1},"category_size": {"footwear.8": 146,"footwear.9": 131,"footwear.10": 122,"footwear.7": 120,"footwear.11": 76,"footwear.8.5": 56,"womens_footwear.6": 43,"footwear.7.5": 39,"womens_footwear.5": 37,"womens_footwear.7": 36,"footwear.9.5": 35,"footwear.12": 33,"footwear.6": 26,"womens_footwear.8": 26,"footwear.13": 25,"footwear.5": 23,"footwear.10.5": 19,"footwear.6.5": 16,"womens_footwear.9": 13,"footwear.11.5": 12,"womens_footwear.8.5": 12,"footwear.5.5": 10,"womens_footwear.6.5": 10,"footwear.14": 8,"womens_footwear.5.5": 8,"womens_footwear.7.5": 8,"footwear.15": 7,"footwear.12.5": 4,"womens_footwear.10": 2,"womens_footwear.4": 2,"womens_footwear.9.5": 2,"womens_footwear.4.5": 1},"designers.name": {"Rick Owens": 1102,"Chrome Hearts": 11,"Rick Owens Drkshdw": 6,"Adidas": 1}},"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.