docs / grailed

Grailed API scraper

base /grailed/v16 endpoints

post/grailed/v1/search1 credit

Search Grailed listings by keyword + filters (designer, category, size, color, condition, department, strata, location, price band) with sorting and pagination. Returns live listings with price, size, condition, designer, photos and a seller summary. The catalog-discovery surface.

Parameter		Allowed / range	Description
query	optional	—	Keywords to search for (give query and/or at least one filter — empty query + a filter browses that facet).
designer	optional	—	Filter to one designer/brand by its EXACT Grailed name (e.g. 'Stone Island', 'Rick Owens', 'Supreme'). Resolve the exact name with the `designers` action.
category	optional	tops · bottoms · outerwear · footwear · tailoring · accessories · womens_tops · womens_bottoms · womens_outerwear · womens_dresses · womens_footwear · womens_accessories · womens_bags_luggage · womens_jewelry	Top-level category facet.
category_path	optional	—	Advanced: exact sub-category path (e.g. 'outerwear.denim_jackets', 'footwear.hi_top_sneakers'). Copy from a listing's category_path.
department	optional	menswear · womenswear	Menswear or womenswear section.
size	optional	—	Size facet (e.g. 'm', 's', 'us 10', '32'). Sizes are category specific — copy the exact value from a search result's `size`.
color	optional	black · white · gray · brown · beige · blue · green · red · purple · pink · yellow · orange · silver · gold · multi	Primary color facet.
condition	optional	is_new · is_gently_used · is_used · is_worn · is_not_specified	Item condition.
strata	optional	grailed · hype · sartorial · basic	Grailed market tier (curation level).
location	optional	United States · Canada · United Kingdom · Europe · Asia · Australia/NZ · Other	Seller location region.
price_from	optional	0–	Only listings at or above this price (USD).
price_to	optional	0–	Only listings at or below this price (USD).
sort = relevance	optional	relevance · newest · price_low · price_high · most_popular · recently_bumped	Result ordering.
page = 1	optional	1–200	Page number (Algolia serves up to 200 pages per query).
per_page = 40	optional	1–100	Results per page (1–100).

Try in playground →

post/grailed/v1/listing_detail1 credit

Full detail for one listing by `id` or `url`: title, description, price, size (pretty + exact), condition, color, category, all photos, measurements, traits, shipping table, designers, sold price, and a seller summary.

Parameter		Allowed / range	Description
id	optional	—	Grailed listing id — the digits in the listing URL (grailed.com/listings/<id>-slug). Take it from search results. Provide id OR url.
url	optional	—	Full Grailed listing URL — alternative to id.

Try in playground →

post/grailed/v1/sold_listings1 credit

Search SOLD listings (resale comps) by keyword + the same filters as search. Each result carries its sold_price and sold_at — the price-history / market-value moat for valuing menswear, streetwear and archive pieces.

Parameter		Allowed / range	Description
query	optional	—	Keywords for the sold-comps search (give query and/or a filter).
designer	optional	—	Filter to one designer/brand by its EXACT Grailed name (e.g. 'Stone Island', 'Rick Owens', 'Supreme'). Resolve the exact name with the `designers` action.
category	optional	tops · bottoms · outerwear · footwear · tailoring · accessories · womens_tops · womens_bottoms · womens_outerwear · womens_dresses · womens_footwear · womens_accessories · womens_bags_luggage · womens_jewelry	Top-level category facet.
department	optional	menswear · womenswear	Menswear or womenswear section.
size	optional	—	Size facet (e.g. 'm', 's', 'us 10', '32'). Sizes are category specific — copy the exact value from a search result's `size`.
color	optional	black · white · gray · brown · beige · blue · green · red · purple · pink · yellow · orange · silver · gold · multi	Primary color facet.
condition	optional	is_new · is_gently_used · is_used · is_worn · is_not_specified	Item condition.
strata	optional	grailed · hype · sartorial · basic	Grailed market tier (curation level).
price_from	optional	0–	Only listings at or above this price (USD).
price_to	optional	0–	Only listings at or below this price (USD).
sort = newest	optional	newest · relevance · price_high · price_low	Sold-comp ordering.
page = 1	optional	1–200	Page number (Algolia serves up to 200 pages per query).
per_page = 40	optional	1–100	Results per page (1–100).

Try in playground →

post/grailed/v1/seller_listings1 credit

All active listings from one seller's storefront by `seller_id`. Same listing shape as search; paginated. Resolve a seller_id from any search/detail result's seller.id.

Parameter		Allowed / range	Description
seller_id	required	—	Grailed seller (user) id — take it from a listing's seller.id.
query	optional	—	Optional keyword to search within this seller's items.
category	optional	tops · bottoms · outerwear · footwear · tailoring · accessories · womens_tops · womens_bottoms · womens_outerwear · womens_dresses · womens_footwear · womens_accessories · womens_bags_luggage · womens_jewelry	Top-level category facet.
designer	optional	—	Filter to one designer/brand by its EXACT Grailed name (e.g. 'Stone Island', 'Rick Owens', 'Supreme'). Resolve the exact name with the `designers` action.
sort = relevance	optional	relevance · newest · price_low · price_high · most_popular · recently_bumped	Result ordering.
page = 1	optional	1–200	Page number (Algolia serves up to 200 pages per query).
per_page = 40	optional	1–100	Results per page (1–100).

Try in playground →

post/grailed/v1/designers1 credit

Search Grailed's designer/brand directory by name → id, slug, listings_count, logo and departments. Use the returned exact `name` to filter search/sold_listings by designer, and the `slug` for the `designer_detail` action.

Parameter		Allowed / range	Description
query	required	—	Designer/brand name (or part of it) to look up.
page = 1	optional	1–200	Page number (Algolia serves up to 200 pages per query).
per_page = 40	optional	1–100	Results per page (1–100).

Try in playground →

post/grailed/v1/designer_detail1 credit

Designer/brand profile by `slug`: id, title, description, follower count and the exact name to use as a designer filter.

Parameter		Allowed / range	Description
slug	required	—	Designer slug from a designer URL (grailed.com/designers/<slug>) or the `designers` action.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/grailed/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"query":"stone island","per_page":10}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}