Grailed sold data: API reference
Grailed is the resale marketplace for designer menswear and streetwear. source=grailed returns real per sale Grailed sold prices through /v1/sold and /v1/comps, and live Grailed listings through /v1/active.
This page is the technical reference. For coverage, examples and pricing see Grailed on CompsAPI. Parameters, stats, the AI junk filter and errors shared by every source are in the common reference.
GET /v1/sold?source=grailed&q=rick+owens+ramones&stats=1
GET /v1/comps?source=grailed&q=rick+owens+ramones&days=365
Coverage
- Sold history back to 2017. A
startdate ordaysvalue reaches all of it.
What a Grailed row carries
On top of the sold price, a Grailed row carries how long the listing took to sell, how far under list it sold, every price drop along the way, and the seller's rating, rating count, sold count and trusted seller standing.
Fields in raw
raw field | Meaning |
|---|---|
list_price | What it was listed at before it sold. |
discount_pct | How far under list it sold, as a percentage. |
price_drops | The list of price drops over the listing's life. |
days_on_market, days_on_market_listing | Time from listing to sale. |
listed_date, created_at, original_listed_date | Listing dates, including the original before any relist. |
relisted_after_sale, repost_id, repost_chain_len | Relist signals, so a bumped listing does not read as a fresh one. |
seller_rating, seller_rating_count, seller_sold_count, trusted_seller | The seller's rating, how many ratings back it, their sales count and whether Grailed marks them trusted. |
seller_username, seller_id | The seller. |
designers, size, color, department | Item attributes. |
followers, photo_count | Listing demand signals. |
signals carries days_on_market, discount_pct, listed_date and seller with username, rating, rating_count, items_sold and verified (trusted seller).
Condition labels
condition is one of new, gently_used, used or worn, on sold rows and on live listings alike. Pass one of those words in condition. stats.by_condition shows the labels present in your search.
A sold row
Trimmed for length: null fields and the common fields from the shared reference are left out.
{
"source": "grailed",
"title": "AW2012 Mountain D-Ring Laceless Leather Ramones Boots",
"price": 455.0,
"last_sold": "2026-11-17T19:34:59Z",
"condition": "gently_used",
"format": "FIXED_PRICE",
"shipping_cost": 20.0,
"url": "https://www.grailed.com/listings/111176909",
"authenticity": {
"basis": "seller_declared",
"verified": false,
"grader": null,
"grade": null,
"cert_number": null
},
"signals": {
"days_on_market": 14.1,
"discount_pct": 22.9,
"listed_date": "2026-11-03T17:31:09Z",
"seller": {
"username": "example_seller",
"rating": 4.797752808988764,
"rating_count": 89,
"items_sold": 395,
"verified": false
}
},
"raw": {
"size": "11.5",
"designers": "Rick Owens",
"list_price": 590.0,
"price_drops": [],
"sold_price_includes_shipping": false,
"created_at": "2026-11-03T17:31:09.624Z",
"seller_username": "example_seller",
"seller_rating": 4.797752808988764,
"seller_rating_count": 89,
"seller_sold_count": 395,
"trusted_seller": false,
"department": "menswear",
"location": "Europe",
"color": "black",
"photo_count": 19,
"makeoffer": true,
"dropped": false,
"followers": 50,
"buynow": true,
"price_updated_at": "2026-11-11T17:39:21.567Z",
"bumped_at": "2026-11-11T17:39:38.311Z",
"traits": [
{
"name": "color",
"value": "black"
},
{
"name": "country_of_origin",
"value": "IT"
}
],
"styles": [
"luxury"
],
"relisted_after_sale": false
}
}
Live listings
GET /v1/active?source=grailed&q= returns what is for sale on Grailed right now for your search, read at the moment you call. Each row is a fixed-price listing with its shipping cost. raw adds when it was listed and last bumped, how many price drops it has had, designers, size, color, and the seller's rating, sold count and trusted flag.
- Sort: best_match, newly_listed, price_asc, price_desc.
source=allincludes this marketplace;live_status.grailedtells you whether its search answered.total_activecounts the listings this search returned, not every live listing on the site.
A live row from 17 November 2026 (search rick owens ramones):
{
"item_id": "grailed-104542272",
"title": "Ramones",
"url": "https://www.grailed.com/listings/104542272",
"price": 200.0,
"price_max": null,
"currency": "USD",
"shipping": 15.99,
"shipping_text": null,
"format": "BIN",
"bids": null,
"ends_at": null,
"buy_it_now_available": true,
"best_offer_enabled": true,
"quantity_available": null,
"condition": "worn",
"seller": "example_seller",
"seller_feedback": 226,
"seller_positive_pct": null,
"location": "United States",
"source": "grailed",
"authenticity": {
"basis": "seller_declared",
"verified": false,
"grader": null,
"grade": null,
"cert_number": null
},
"raw": {
"listed_date": "2026-08-30T20:47:24.950Z",
"bumped_at": "2026-09-21T19:13:42.268Z",
"price_updated_at": "2026-09-21T19:13:25.375Z",
"price_drops": null,
"designers": "Rick Owens",
"size": "6",
"category": "footwear.hitop_sneakers",
"department": "menswear",
"color": "black",
"followers": 20,
"photo_count": 13,
"seller_rating": 4.973451327433628,
"seller_sold_count": 391,
"trusted_seller": true,
"dropped": false
}
}
The shared parameters and fields are under live listings.
Limits
authenticity.basisisseller_declared. Weighseller_rating,seller_sold_countandtrusted_selleryourself.- A sale whose item was relisted afterwards carries
raw.relisted_after_sale: true. Such a sale may have fallen through, and it is still returned and counted instats, so filter on that field when it matters. us_saleis an eBay field and isnullhere.