Grailed Marketplace Scraper

Scrape fashion listings from Grailed — the premier peer-to-peer marketplace for men's streetwear, luxury designer clothing, and vintage fashion. Find listings from brands like Supreme, Off-White, Rick Owens, Yeezy, Stone Island, Bape, and thousands more.

What This Actor Does

This actor searches the Grailed marketplace and returns structured listing data including prices, photos, seller info, condition, and direct links to each listing. Use it to:

• Monitor prices for specific items or brands
• Research market trends across streetwear and designer fashion
• Build price comparison tools for resale fashion
• Track availability of limited-edition items
• Analyze seller activity and listing patterns

Search by keyword, designer name, clothing category, size, condition, and price range.

Input Fields

Field	Type	Required	Description
searchQuery	String	No	Keyword search (e.g. "Supreme hoodie", "Yeezy 350")
category	Select	No	Clothing category: tops, bottoms, footwear, outerwear, tailoring, accessories
designerName	String	No	Filter by designer or brand (e.g. "Supreme", "Off-White")
minPrice	Integer	No	Minimum price in USD (0–100000)
maxPrice	Integer	No	Maximum price in USD (0–100000)
size	String	No	Size filter (e.g. "M", "L", "XL", "32", "10")
condition	Select	No	Item condition: is_not_worn, is_gently_used, is_used, is_worn
maxItems	Integer	No	Maximum number of listings to return (default: 20, max: 500)

Condition Values

Value	Description
is_not_worn	Deadstock / new with tags
is_gently_used	Gently used, minimal signs of wear
is_used	Used, moderate signs of wear
is_worn	Heavily worn, distressed

Output Fields

Each scraped listing contains:

Field	Type	Description
listingId	String	Unique Grailed listing ID
title	String	Listing title
designerNames	Array	Designer/brand names (e.g. ["Supreme"])
category	String	Top-level category (e.g. "tops")
subCategory	String	Subcategory (e.g. "hoodies")
size	String	Item size
condition	String	Item condition
price	Number	Price in USD
currency	String	Currency code (typically "USD")
description	String	Listing description from seller
photoUrls	Array	Photo URLs
sellerUsername	String	Grailed username of the seller
sellerLocation	String	Seller's location
soldAt	String	ISO 8601 timestamp if item was sold (omitted if unsold)
listedAt	String	ISO 8601 timestamp when the listing was created
sourceUrl	String	Direct URL to the Grailed listing
scrapedAt	String	ISO 8601 timestamp when the data was scraped

Example Input

{
  "searchQuery": "Supreme Box Logo Hoodie",
  "category": "tops",
  "condition": "is_gently_used",
  "minPrice": 200,
  "maxPrice": 800,
  "maxItems": 10
}

Example Output

{
  "listingId": "12345678",
  "title": "Supreme Box Logo Hoodie Red FW18",
  "designerNames": ["Supreme"],
  "category": "tops",
  "subCategory": "hoodies",
  "size": "L",
  "condition": "is_gently_used",
  "price": 450.0,
  "currency": "USD",
  "description": "Authentic Supreme FW18 Box Logo Hoodie in Red. Worn a few times, great condition. No stains or damage.",
  "photoUrls": [
    "https://media-assets.grailed.com/prd/listing/1.jpg",
    "https://media-assets.grailed.com/prd/listing/2.jpg"
  ],
  "sellerUsername": "hypemaster99",
  "sellerLocation": "New York, NY",
  "listedAt": "2024-10-15T12:30:00+00:00",
  "sourceUrl": "https://www.grailed.com/listings/12345678",
  "scrapedAt": "2026-06-01T00:00:00+00:00",
  "recordType": "listing"
}

Use Cases

• Streetwear price tracking: Monitor going rates for Supreme drops, Nike SB collabs, or Palace items
• Designer resale research: Analyze secondhand market pricing for luxury brands
• Deal hunting: Find underpriced listings before they sell
• Inventory monitoring: Track specific items by size and condition
• Market analytics: Build datasets for fashion resale trend analysis

Frequently Asked Questions

What types of items can I scrape?

Grailed lists men's streetwear, designer clothing, vintage fashion, and luxury goods. Categories include tops (t-shirts, hoodies, shirts), bottoms (pants, shorts, jeans), footwear, outerwear (jackets, coats), tailoring (suits, blazers), and accessories (belts, bags, hats).

How many listings can I retrieve?

You can retrieve up to 500 listings per run using the maxItems parameter. For larger datasets, run the actor multiple times with different search queries or filters.

Can I filter by both keyword and designer?

Yes. Use searchQuery for keyword matching and designerName for brand-specific filtering. Both filters are applied together, so you can search for "hoodie" and filter by designerName: "Supreme" simultaneously.

Are sold listings included?

Both active and sold listings may appear in results. Sold listings will have a soldAt timestamp in the output. Unsold (active) listings do not include the soldAt field.