Grailed API

Search Grailed listings and sold prices, and pull listings, sellers, reviews and designers as clean JSON.

The API.SH Grailed API turns public Grailed data into structured JSON. Search live or sold listings with the shop's own filters (department, category, size, designer, condition, color, location, market, price range) and sort orders, then pull one listing with its photos, measurements and shipping prices, similar listings, a seller's public profile, items for sale and reviews, the designer directory, designer pages, categories, editorial collections and search suggestions. Sold searches return each item's sold price and date.

Get a free API key Try it in the playground

12 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Grailed search suggestions

GET https://api.api.sh/grailed/v1/autocomplete

{"query": "rick","suggestions": [{"query": "rick owens","results": 87654,"popularity": 17199},{"query": "rick owens geobasket","results": 920,"popularity": 4316},"… 8 more"],"designers": [{"id": 32,"name": "Rick Owens","slug": "rick-owens","url": "https://www.grailed.com/designers/rick-owens","listings": 49286,"departments": ["menswear","womenswear"]},{"id": 583,"name": "Rick Owens Drkshdw","slug": "rick-owens-drkshdw","url": "https://www.grailed.com/designers/rick-owens-drkshdw","listings": 9453,"departments": ["menswear","womenswear"]},"… 6 more"],"cached": false,"credits_used": 1}

1 credit · $1 per 1,000 calls

What you can build with the Grailed API

Resale price research

Search sold listings for a designer or model and read each sale's price and date to see what pieces actually sell for, then compare them with live asking prices.

/search /listing

Archive and streetwear deal alerts

Run the same search with a size, condition and price cap every few minutes, sorted by newest, and alert on new listings or price drops.

/search /similar

Seller vetting

Check a seller's rating, review count, transaction count, badges and recent reviews, and see everything they have for sale, before you buy or partner with them.

/seller /seller-reviews /seller-listings

Designer and category trend tracking

Track how many listings each designer has, which collaborations exist and how supply moves across categories and sizes over time.

/designers /designer /categories

Curated feeds and search boxes

Pull Grailed's editorial collections and their listings for a content feed, and use the suggestion endpoint to power a search box with real query counts.

/collections /collection /autocomplete

Grailed data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Grailed search suggestions/grailed/v1/autocomplete

queryrick

suggestions[]query · results · popularity

designers[]id · name · slug · url · listings · departments

Grailed categories/grailed/v1/categories

count14

categories[]name · path · slug · department · group · subcategories · sizes

Grailed collection/grailed/v1/collection

id1977nameGood Vintage Under $100sluggood-vintage-under-100urlhttps://www.grailed.com/collecti…descriptionShop our favorite vintage pieces…imagehttps://media-assets.grailed.com…followers378shows_sold_listingsfalsepublished_at2026-10-06T20:16:35.834Zcreated_at2026-10-06T16:47:09.171Ztotal_listing_ids607page1next_page2count38

listings[]id · title · url · designers · designer_names · price · currency · sold · sold_price · sold_at · sold_shipping_price · size

related_collections[]id · name · slug · url · description · image · followers · shows_sold_listings · published_at · created_at

Grailed API endpoints and prices

Every Grailed endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

Grailed search suggestions /grailed/v1/autocomplete params qdocs try	$1 · $2 PAYG 1 credit
Grailed listing search /grailed/v1/search params none required +18 optionaldocs try	$1 · $2 PAYG 1 credit

Profiles and accounts3

Grailed seller /grailed/v1/seller params usernamedocs try	$1 · $2 PAYG 1 credit
Grailed seller listings /grailed/v1/seller-listings params username +1 optionaldocs try	$1 · $2 PAYG 1 credit
Grailed seller reviews /grailed/v1/seller-reviews params username +1 optionaldocs try	$1 · $2 PAYG 1 credit

Products, listings and places2

Grailed listing /grailed/v1/listing params iddocs try	$1 · $2 PAYG 1 credit
Grailed similar listings /grailed/v1/similar params iddocs try	$1 · $2 PAYG 1 credit

More data5

Grailed categories /grailed/v1/categories params none required +1 optionaldocs try	$1 · $2 PAYG 1 credit
Grailed collection /grailed/v1/collection params slug +1 optionaldocs try	$1 · $2 PAYG 1 credit
Grailed collections /grailed/v1/collections params none required +1 optionaldocs try	$1 · $2 PAYG 1 credit
Grailed designer /grailed/v1/designer params slugdocs try	$1 · $2 PAYG 1 credit
Grailed designers /grailed/v1/designers params none required +3 optionaldocs try	$1 · $2 PAYG 1 credit

Call the Grailed API

Grailed search suggestions: GET https://api.api.sh/grailed/v1/autocomplete

curl "https://api.api.sh/grailed/v1/autocomplete?q=rick" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/grailed/v1/autocomplete",
    params={"q": "rick"},
    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/autocomplete");
url.searchParams.set("q", "rick");

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();

# Google Sheets (API.SH add-on)
=APISH("/grailed/v1/autocomplete", "q", "rick")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Grailed" and "Grailed search suggestions".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 902 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Grailed data

Public data only: no Grailed login, cookies or account needed
One key and one response shape for Grailed and 901 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
No rate limits: run as many calls in parallel as you need
Live status for every endpoint

API.SH vs the official Grailed API

Grailed does not offer a public developer API; GitHub projects and blog posts that rank for the term note the same and build their own scrapers. API.SH gives you Grailed's public listing, sold-price, seller and designer data through one key without an account.

Skip maintaining a Grailed scraper from GitHub or paying per record for Apify actors and datasets: API.SH returns the same public data as JSON with a fixed price per call and the same response shape as every other platform.

Grailed API questions

What Grailed data can I get?+

Listing search with every shop filter, live or sold (/grailed/v1/search), one listing (/grailed/v1/listing), similar listings (/grailed/v1/similar), seller profiles (/grailed/v1/seller), a seller's listings (/grailed/v1/seller-listings) and reviews (/grailed/v1/seller-reviews), the designer directory (/grailed/v1/designers), one designer (/grailed/v1/designer), categories (/grailed/v1/categories), editorial collections (/grailed/v1/collections, /grailed/v1/collection) and search suggestions (/grailed/v1/autocomplete).

How much does the Grailed API cost?+

Every Grailed endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /grailed/v1/autocomplete at 1 credit each.

Is there an official Grailed API?+

No. Grailed does not publish a public API for listings or sold prices. API.SH reads the public site and returns it as JSON.

Do I need a Grailed account or login?+

No. Every endpoint reads public Grailed data. No login, cookies or Grailed account is used, and buyers in reviews are not named.

Can I get Grailed sold prices?+

Yes. Call /grailed/v1/search with sold=true and any keywords or filters. Each result has its sold price, sold date and sold shipping price, and you can sort by most recently sold or by price.

Can I use the Grailed API from Python or JavaScript?+

Yes. It is a plain HTTPS API that returns JSON, so any language works: requests in Python, fetch in JavaScript, or curl. Official SDKs are listed in the docs.

How do I get started?+

Sign up at api.sh, copy your API key and call /grailed/v1/search?q=rick owens. Docs and a playground are at https://api.sh/docs; you can also use the SDKs, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.

Does the Grailed API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many Grailed calls in parallel as you need and pay only for the calls that run. If Grailed itself slows down, the call returns 503 with a retry-after header and is not charged.