Grailed seller listings
GET https://api.api.sh/grailed/v1/seller-listings
What a seller has for sale, 20 per page, newest first: each listing with price, size, condition, category, description, price drops, followers and cover image, plus raw. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the Grailed API: 12 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
usernamerequired | string | The seller's username, numeric id or profile link. Example: GreatDaniDay |
page | integer | Page number (default 1). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/grailed/v1/seller-listings?username=GreatDaniDay" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/grailed/v1/seller-listings",
params={"username": "GreatDaniDay"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/grailed/v1/seller-listings");
url.searchParams.set("username", "GreatDaniDay");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"seller_id": 6155829,"username": "GreatDaniDay","page": 1,"count": 20,"next_page": 2,"listings": [{"id": 110511861,"title": "Y2K LGB Hysteric Japanese Flare Bootcut Archive Avant Garde","url": "https://www.grailed.com/listings/110511861-if-six-was-nine-y2k-lgb-hysteric-japanese-flare-bootcut-archive-avant-garde","designers": [{"id": 9612,"name": "If Six Was Nine","slug": "if-six-was-nine"}],"designer_names": "If Six Was Nine","price": 65,"currency": "USD","sold": false,"sold_price": null,"sold_at": null,"sold_shipping_price": null,"size": "32","pretty_size": "US 32 / EU 48","condition": "is_gently_used","condition_label": "Gently used","department": "menswear","category": null,"category_path": "bottoms.denim","color": null,"styles": ["streetwear"],"strata": "grailed","location": null,"buy_now": true,"make_offer": true,"dropped": false,"price_drops": [],"followers": 151,"badges": [],"image": "https://media-assets.grailed.com/prd/listing/temp/3a1c392be6aa4caca3977ea2e7e50606","created_at": "2026-10-29T20:28:35.621Z","bumped_at": null,"price_updated_at": "2026-11-05T20:27:53.749Z","seller": {"id": 6155829},"description": "\"FOLLOW MY SHOP TO CHECK DAILY UPDATES & PRICE DROPS\n\n💥Send Your Offer💥\n\n🟣Size: 32x32\n🟣Condition: 9 / 10\n💸You can always offer your price fo…"},{"id": 110511827,"title": "Y2K LGB Hysteric Japanese Flare Bootcut Archive Avant Garde","url": "https://www.grailed.com/listings/110511827-if-six-was-nine-y2k-lgb-hysteric-japanese-flare-bootcut-archive-avant-garde","designers": [{"id": 9612,"name": "If Six Was Nine","slug": "if-six-was-nine"}],"designer_names": "If Six Was Nine","price": 65,"currency": "USD","sold": false,"sold_price": null,"sold_at": null,"sold_shipping_price": null,"size": "34","pretty_size": "US 34 / EU 50","condition": "is_gently_used","condition_label": "Gently used","department": "menswear","category": null,"category_path": "bottoms.denim","color": null,"styles": ["streetwear"],"strata": "grailed","location": null,"buy_now": true,"make_offer": true,"dropped": false,"price_drops": [],"followers": 147,"badges": [],"image": "https://media-assets.grailed.com/prd/listing/temp/0fc002c933804033a1cd98672e2d032b","created_at": "2026-10-29T20:28:28.939Z","bumped_at": null,"price_updated_at": "2026-11-05T20:27:53.749Z","seller": {"id": 6155829},"description": "\"FOLLOW MY SHOP TO CHECK DAILY UPDATES & PRICE DROPS\n\n💥Send Your Offer💥\n\n🟣Size: 34x32\n🟣Condition: 9 / 10\n💸You can always offer your price fo…"},"… 18 more"],"cached": false,"credits_used": 1}The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.