GET/grailed/categoriesapiKey1 credit/request
Returns Grailed's full facet taxonomy for the enum-like parameters grailed-search/grailed-sold-listings accept: department, category, category_path (a more granular subcategory slug), condition, color, and size, each with its own live listing count. department and condition are exhaustive closed sets (2 and 5 values respectively); category/category_path/color/size are the full, exhaustive value space as of the request. Designer is NOT included here (7,363 values, far too large for a facet-count response) -- see grailed-designers for that discovery endpoint.
Takes no parameters.
Sampled 14 Oct 2026: 128 items. Filled in every item: value, count. In the sample: count: 234 to 1,821,157, median 29,175; value: “tops.short_sleeve_shirts” and 127 other values.
Open in Playground
GET/grailed/collectionapiKey2 credits/request
Returns one Grailed curated homepage collection's full listing set. id is the collection's numeric id, from grailed-collections' own collections[].id field. An unknown id returns a typed not-found error.
Required: id.
Sampled 14 Oct 2026: 20 items. Filled in every item: id, title, url, designers, price, currency, sold, condition and 8 more. In the sample: condition: is_gently_used (17), is_used (3); price: 350 to 900, median 500; title: “Rick Owens Detroit Cut Waxed Denim” and 19 other values; url: grailed.com; sold: true in 0 of 20; designers: median 1 entry; size: “30” and 9 other values; category_path: bottoms.denim (7), tops.sweatshirts_hoodies (4), footwear.hitop_sneakers (2) and 5 more.
Open in Playground
GET/grailed/collectionsapiKey1 credit/request
Returns Grailed's own curated homepage merchandising collections (e.g. "Trending: Apparel", "Dark Luxury", "Chromed Out") -- editorial/trending shelves distinct from a plain search or facet browse. Each collection's numeric id is the value grailed-collection's own id parameter accepts.
Takes no parameters.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, title, external_id, last_refreshed_at, top_designers, preview_photos. In the sample: last_refreshed_at: 2026-10-12; title: “Trending: Apparel” and 9 other values; top_designers: median 3 entries; preview_photos: median 5 entries.
Open in Playground
GET/grailed/designersapiKey1 credit/request
Returns a page of Grailed's full designer/brand taxonomy (7,363 designers as of 2026-09-09) -- the value space grailed-search/grailed-sold-listings' own designer parameter accepts (by name). q is an optional free-text filter (typo-tolerant, e.g. a partial name for typeahead-style lookup); an empty q lists the full taxonomy ordered by Grailed's own default ranking (most-listed designers first).
Optional: q, page, limit.
Sampled 14 Oct 2026: 2 items. Filled in every item: id, name, slug, listings_count, departments. Not in every item: logo_url (1). In the sample: listings_count: 809 to 114,297, median 809; name: “Gucci” and 1 other value; logo_url: media-assets.grailed.com; departments: median 2 entries.
Open in Playground
GET/grailed/listingapiKey3 credits/request
Returns full listing-detail data for one Grailed listing: description, every photo, measurements, designers, and the seller's full profile -- richer than the flattened summary grailed-search/grailed-sold-listings return per listing. id is the listing's numeric id, from a search or sold-listings result's own listings[].id field.
Required: id.
Sampled 14 Oct 2026: 40 fields returned with a value. In the sample: created_at: 2026-09-08; price: 400; title: “Chateau Marmont Gucci Tshirt Red Japan Exclusive”; url: grailed.com; sold: false; description: 589 characters; designers: 1 entry; currency: “USD”.
Open in Playground
GET/grailed/searchapiKey2 credits/request
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.
Optional: q, designer, department (2 allowed values: menswear, womenswear), category, size, color, condition (5 allowed values: is_new, is_gently_used, is_used, is_worn, is_not_specified), min_price, max_price, sort (8 allowed values: heat, heat_recency, followers, newest, price_asc, price_desc, recently_updated, quality), page, limit.
Sampled 14 Oct 2026: 24 items. Filled in every item: id, title, url, designers, price, currency, sold, condition and 13 more. Not in every item: follower_count (23). In the sample: 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; title: “Gucci wool beanie hat” and 22 other values; url: grailed.com; sold: true in 0 of 24; designers: median 1 entry; size: “one size” and 9 other values.
Open in Playground
GET/grailed/seller-reviewsapiKey2 credits/request
Returns a page of a Grailed seller's individual buyer feedback entries (rating, note, feedback tags, and the listing each review was left for) -- reputation detail grailed-seller does not carry (grailed-seller only exposes the aggregate rating_average/rating_count). username is the seller's Grailed username, from a listing's own seller.username field or grailed.com/{username}. An unknown username returns a typed not-found error.
Required: username. Optional: page.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, rating, created_at, listing. Not in every item: note (2), tags (7). In the sample: created_at: 2024-11-25 to 2026-09-26; rating: 3 to 5, median 5; tags: median 3 entries.
Open in Playground
GET/grailed/sellerapiKey2 credits/request
Returns a Grailed seller's public profile plus a page of their current active listings (Grailed's own "shop" view of a seller). username is the seller's Grailed username, from a listing's own seller.username field or grailed.com/{username}. Listings only ever contains that seller's ACTIVE listings; use grailed-sold-listings with a designer/query filter for a broader sales-history lookup, since sold listings are not filterable by seller through this endpoint. An unknown username returns a typed not-found error.
Required: username. Optional: page, limit.
Sampled 14 Oct 2026: 6 items. Filled in every item: id, title, url, designers, price, currency, sold, condition and 14 more. In the sample: created_at: 2026-03-12 to 2026-10-09; price: 145 to 800, median 249; url: grailed.com; sold: true in 0 of 6; designers: median 1 entry; cover_photo_url: media-assets.grailed.com; photo_count: 5 to 9, median 5; follower_count: 26 to 1,880, median 39.
Open in Playground
GET/grailed/similar-listingsapiKey2 credits/request
Returns the listings Grailed's own product page recommends as "similar" to one listing -- the same related-items shelf shown on grailed.com's own listing-detail page. id is the listing's numeric id, from a search, sold-listings, or collection result's own id field. An id for a listing that does not exist (deleted, sold and removed, or never valid) returns a typed not-found error.
Required: id. Optional: limit.
Sampled 14 Oct 2026: 30 items. Filled in every item: id, title, url, designers, price, currency, sold, condition and 13 more. Not in every item: follower_count (29). In the sample: created_at: 2026-05-27 to 2026-10-12; condition: is_gently_used (27), is_new (2), is_used (1); price: 108 to 849, median 400; title: “Chateau Marmont Gucci Tshirt Red Japan Exclusive” and 25 other values; url: grailed.com; sold: true in 0 of 30; designers: median 1 entry; size: m (15), s (7), xs (5) and 2 more.
Open in Playground
GET/grailed/sold-listingsapiKey2 credits/request
Searches Grailed's SOLD-listing index -- a separate dataset from active listings, carrying each item's final sale price and sale date. Same filter shape as grailed-search (q, designer, department, category, size, color, condition), but min_price/max_price filter the SOLD price, not the original asking price. Useful for sale-price-history/comparable-sales lookups (e.g. "what did this designer/category actually sell for recently"). A query with genuinely zero matches returns a well-formed empty result rather than an error.
Optional: q, designer, department (2 allowed values: menswear, womenswear), category, size, color, condition (5 allowed values: is_new, is_gently_used, is_used, is_worn, is_not_specified), min_price, max_price, sort (3 allowed values: recent, price_asc, price_desc), page, limit.
Sampled 14 Oct 2026: 24 items. Filled in every item: id, title, url, designers, price, currency, sold, sold_price and 15 more. Not in every item: follower_count (23). In the sample: sold_at: 2026-10-12 to 2026-10-13; condition: is_used (12), is_gently_used (9), is_new (3); price: 122 to 972, median 182; title: “Size 100/40 - Gucci Black Silver Leather Interlocking” and 23 other values; url: grailed.com; sold: true in 24 of 24; designers: median 1 entry; sold_price: 50 to 580, median 165.
Open in Playground
GET/grailed/suggestapiKey3 credits/request
Returns Grailed's own search-box typeahead suggestions for a partial query -- a flat list of suggested search phrases with a popularity score and live active-listing match count, no listing data. Pass a suggestion straight through to grailed-search/grailed-sold-listings' own q parameter. A query with no genuine matches returns a well-formed empty result rather than an error.
Required: q.
Sampled 14 Oct 2026: 10 items. Filled in every item: query, popularity. Not in every item: total_results (5). In the sample: popularity: 2,597 to 20,484, median 3,070; query: “gucci” and 9 other values; total_results: 2,346 to 202,372, median 10,626.
Open in Playground
Grailed API endpoints