Grailed Marketplace Scraper

Searches Grailed, the streetwear and designer fashion resale marketplace, for a keyword and returns the matching listings with title, designer, price, size, condition, category, image and listing URL. Built for resale price research and monitoring listings for specific brands or items.

Features

• Free-text keyword search using the same search backend the Grailed website uses
• Returns structured listing data (no HTML parsing of cards), so fields are consistent
• Designer names joined into a single string when a listing has several
• maxItems caps the number of listings returned (1 to 200 in the schema, effectively up to 100 per run, see Limitations)
• Fetches the Grailed shop page through a residential proxy layer to resolve the search configuration, with retries and a direct fallback

Input

Field	Type	Required / default	Description
query	string	required (no default)	Search term, for example carhartt jacket
maxItems	integer	default 30, min 1, max 200	Maximum number of listings to return

If query is empty the run pushes a warning item and exits.

Example input:

{
  "query": "carhartt jacket",
  "maxItems": 30
}

Output

One dataset item per listing:

• listingId - Grailed listing ID
• title - listing title
• designer - designer or brand name(s), comma separated
• price - listing price as a number (USD as shown on Grailed), or null
• size - size label, or null
• condition - condition label (for example is_gently_used), or null
• category - Grailed category path, or null
• imageUrl - cover photo URL, or null
• listingUrl - absolute URL of the listing
• scrapedAt - ISO timestamp of the extraction

If the search returns nothing the run pushes one item with query and warning. A failure pushes query, error: "fetch-failed" and message.

{
  "listingId": 65432100,
  "title": "Carhartt Detroit Jacket Brown",
  "designer": "Carhartt",
  "price": 120,
  "size": "L",
  "condition": "is_gently_used",
  "category": "outerwear.denim_jackets",
  "imageUrl": "https://media-assets.grailed.com/prd/listing/...",
  "listingUrl": "https://www.grailed.com/listings/65432100-carhartt-detroit-jacket-brown",
  "scrapedAt": "2026-09-10T12:00:00.000Z"
}

Pricing

Pay per event. The Actor charges the item-scraped event ("Item scraped") at $0.0015 per listing item returned. Warning and error items are not charged. There is no separate Actor start fee.

Free plan

The Actor checks whether the run belongs to a paying Apify account. On the free plan maxItems is capped at 10 per run, so free users receive up to 10 real listings to inspect the output format. Larger runs require a paid Apify plan.

Usage

From the Apify console, type a keyword into query, set maxItems and click Start.

Via API:

curl -X POST "https://api.apify.com/v2/acts/gio21~grailed-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query": "carhartt jacket", "maxItems": 30}'

Limitations

• A single search request is made per run with at most 100 hits, so values of maxItems above 100 still return up to 100 listings
• No filters for designer, size, price range, condition or sold status, and no sorting options
• Seller information, description text, favourites count and posting date are not extracted
• Results depend on the search configuration embedded in the Grailed shop page; if that page changes or is blocked the run returns a fetch-failed item
• Prices are returned as numbers without an explicit currency field

This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Grailed or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.