Grailed seller
GET https://api.api.sh/grailed/v1/seller
A Grailed seller's public profile: id, username, avatar, location and country, member since, transactions, rating average and count, sold and purchase counts, review tags, listings for sale, followers, following, trusted, verified, quick responder and speedy shipper badges, vacation flag, plus the first listings for sale and the latest reviews. profile_complete is false when the seller has nothing for sale (the stats then come only from the reviews).
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 grailed.com/<username> profile link. Example: GreatDaniDay |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/grailed/v1/seller?username=GreatDaniDay" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/grailed/v1/seller",
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");
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)
{"id": 6155829,"username": "GreatDaniDay","url": "https://www.grailed.com/GreatDaniDay","avatar": "https://media-assets.grailed.com/prd/avatar/6155829/57e4877edf94492580dc208999ccd25b","location": "Europe","country_code": "UA","joined_at": "2021-02-07T21:01:21.218Z","total_transactions": 1257,"rating_average": 4.7,"rating_count": 434,"sold_count": 1255,"purchase_count": 2,"review_tags": ["fast-shipper","quick-replies","… 1 more"],"listings_for_sale": 1096,"followers": 668,"following": 67,"trusted_seller": false,"verified": false,"quick_responder": true,"speedy_shipper": false,"power_seller_group": "tier_1","on_vacation": false,"profile_complete": true,"listings_preview": [{"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}},{"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}},"… 18 more"],"recent_reviews": [{"id": 7382644,"rating": 1,"note": "Ordered a size 32 and sent me some lil girl jeans ","tags": [],"created_at": "2026-10-31T18:39:58.207Z","listing": {"id": 105462453,"title": "IF SIX WAS NINE BOOTCUT FLARED Y2K 2000S DENIM JEANS SIZE 32","url": "https://www.grailed.com/listings/105462453-if-six-was-nine-if-six-was-nine-bootcut-flared-y2k-2000s-denim-jeans-size-32","designers": "If Six Was Nine","price": 65,"sold_price": 85,"size": "US 32 / EU 48","image": "https://media-assets.grailed.com/prd/listing/temp/d970b7e1df864e8a9803f8f6d9983b58"}},{"id": 7382615,"rating": 5,"note": null,"tags": ["item-as-described"],"created_at": "2026-10-31T17:46:24.135Z","listing": {"id": 99290798,"title": "Lao San LS Y2K Straight Bootcut Flared Jeans Faded Distressed 2000s Retro","url": "https://www.grailed.com/listings/99290798-if-six-was-nine-lao-san-ls-y2k-straight-bootcut-flared-jeans-faded-distressed-2000s-retro","designers": "If Six Was Nine","price": 45,"sold_price": 60,"size": "US 33","image": "https://media-assets.grailed.com/prd/listing/temp/7d612b9fd08a4a7291dc3fda5a5530f9"}},"… 8 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.