← Marketplace reference

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.

https://api.compsapi.com

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

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 fieldMeaning
list_priceWhat it was listed at before it sold.
discount_pctHow far under list it sold, as a percentage.
price_dropsThe list of price drops over the listing's life.
days_on_market, days_on_market_listingTime from listing to sale.
listed_date, created_at, original_listed_dateListing dates, including the original before any relist.
relisted_after_sale, repost_id, repost_chain_lenRelist signals, so a bumped listing does not read as a fresh one.
seller_rating, seller_rating_count, seller_sold_count, trusted_sellerThe seller's rating, how many ratings back it, their sales count and whether Grailed marks them trusted.
seller_username, seller_idThe seller.
designers, size, color, departmentItem attributes.
followers, photo_countListing 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.

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