Grailed

Grailed asking price, original price, sold price and date, designers, size, condition, category, seller and likes, by listing id, about 20 million listings per credit. Sold listings too, in bulk. Search for available or sold listings. No listing rating.

Embed

<a href="https://scrapelyserp.com/docs/grailed-products"><img src="https://scrapelyserp.com/docs/_api/public/orgs/affc5b0f-d3c2-423a-8143-9d10db5736ae/spaces/981e6275-da3f-446c-82de-889f59c83b6f/pages/2882bd0e-9f87-42c8-bfad-0aba941ae0f6/social-card.svg?v=3e7ae33eec8b" alt="Grailed" width="600" height="315"></a>

At a glance

Property	Value
`platform`	`grailed`
Item id	The number after `/listings/` in a Grailed listing link, `https://www.grailed.com/listings/111350058-fragment-design-x-union-la` (`111350058`). A pasted listing link is reduced to its id. Search returns the same id.
Marketplaces	Live: `us`.
Tier	`standard` (the default), about 20 million listings per credit (an estimate until production traffic measures it)
Ids per call	1,000, looked up together: available and sold listings in the same call.
Typical call	1–5 s for 1,000 listings
Search	`GET /v1/structured/grailed/search` by keyword, for available or sold listings, about 20 million results per credit.

Asking price versus sold price

price is the asking price: the last price the seller set, also on a sold listing. What a sold listing sold for is grailed.soldPrice, and it can be lower, because an accepted offer sells below the ask (asked 100, sold 60 is a real case). Read grailed.soldPrice, grailed.soldAt and grailed.soldShippingPrice on a sold listing; on an available one they are null.

Original price

grailed.originalPrice is the first price in the listing's price-drop history, and null when the price never dropped (it is not 0). It is the earliest ask the history holds: it is not a retail price and not a claim about a discount.

Search reaches 1,000 listings per query

However large total_results is, a query returns its first 1,000 listings (page 1 to 10, 100 each). To go deeper, split the query with department, condition, min_price / max_price, size and designer. Asking by id has no such limit.

Example

cURL
Python
Node.js

curl -X POST "https://api.scrapelyserp.com/v1/products" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "grailed",
    "ids": ["111350058", "https://www.grailed.com/listings/103041652-jordan"]
  }'

import os
import requests

HEADERS = {"Authorization": f"Bearer {os.environ['SCRAPELY_API_KEY']}"}

r = requests.post(
    "https://api.scrapelyserp.com/v1/products",
    headers=HEADERS,
    json={
        "platform": "grailed",
        "ids": [
            "111350058",
            "https://www.grailed.com/listings/103041652-jordan",
        ],
    },
    timeout=30,
)
r.raise_for_status()
data = r.json()
for p in data["results"]:
    print(p["id"], p["status"], (p.get("price") or {}).get("amount"), (p.get("grailed") or {}).get("soldPrice"))

const res = await fetch('https://api.scrapelyserp.com/v1/products', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SCRAPELY_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    platform: 'grailed',
    ids: ['111350058', 'https://www.grailed.com/listings/103041652-jordan'],
  }),
  signal: AbortSignal.timeout(30_000),
});
if (!res.ok) throw new Error((await res.json()).error.code);
const data = await res.json();
for (const p of data.results) console.log(p.id, p.status, p.price?.amount, p.grailed?.soldPrice);

Full reference → POST /v1/products

Grailed fields

Besides the common fields, each result carries a grailed object.

Field	Description
`price`	The asking price, in dollars. `null` if Grailed gives none. On a sold listing it is still the ask: see `grailed.soldPrice`.
`availability`	`inStock` is true for an available listing and false for a sold one, from Grailed's own sold flag.
`grailed.status`	`available` or `sold`.
`grailed.soldPrice`, `soldAt`, `soldShippingPrice`	What a sold listing sold for, when (ISO 8601), and the shipping charged, as Grailed gives it (a charge of 0 stays 0). `null` on an available listing, and `soldPrice` is `null` when Grailed gives none.
`grailed.originalPrice`	The first price in the price-drop history; `null` when the price never dropped.
`grailed.size`	The size as the listing shows it. Free text: `l`, `10`, `36`, `7.5`.
`grailed.condition`	`new`, `gently_used`, `used` or `worn`. Any other Grailed code is passed as written; `null` when the listing has none.
`grailed.brand`, `department`, `category`, `likes`, `listedAt`	The designers (`A × B` for a collaboration), `menswear` or `womenswear`, the category (`footwear`, `tops`), how many people follow the listing, and when it was created.
`grailed.seller`, `sellerRating`, `sellerRatingCount`	The seller's username and the seller's own average rating and number of ratings. These describe the seller, not the listing; `null` until the seller has ratings.
`url`, `images`	The listing link and its cover picture. See the note on links below.
Not given	A rating or review count for the listing (listings have none), the listing's other pictures, description, measurements and shipping options.

Listing links

The url is https://www.grailed.com/listings/<id>, built from the id alone. Grailed's own links add a title slug after the id (/listings/111350058-fragment-design-x-union-la); both carry the same id, and a pasted link in either form is accepted.

Statuses on Grailed

partial: Grailed answered without a title. Ask again later.
not_found: Grailed has no such listing id, available or sold. A deleted listing is not found.
unavailable: no usable answer after retries. Not charged; ask again.

Updated Nov 6, 2026

Was this page helpful?