# Grailed Scraper — Streetwear Resale & Sold Prices | $1.50/1K (`bovi/grailed-listings`) Actor Search Grailed resale listings via the public Algolia API. Returns price, price\_drops, sold\_price, condition, designer, size, strata (hype/luxury), seller score. Two-tier PPE: $1.50/1K active, $2.50/1K sold listings with confirmed prices. No proxy. Pay per result. - **URL**: https://apify.com/bovi/grailed-listings.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** E-commerce, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Grailed Scraper — Streetwear Resale + Sold Prices | from $1.50/1K | No Proxy Built for streetwear resellers doing arbitrage between Grailed, StockX, and eBay — and for brand analysts tracking which designers are trending in the secondary market. **Pricing:** Two-tier PPE — $1.50/1K (active listings), $2.50/1K (sold listings with confirmed `sold_price`). First 10 results free. **No proxy. No login. Self-healing Algolia key rotation.** Search Grailed listings by keyword, designer, category, or size via the public Algolia search API. Returns clean structured data including price history, condition, designers, seller score, and sold status. No proxy required. Pay per result. ### Features - **Search any keyword** — brands, styles, items, designer names - **24 normalized fields** — price, price_drops, condition, designers, category, size, color, sold, seller_username, seller_score, seller_reviews, cover_photo, listing_url, created_at, and more - **parse_confidence field** — quality indicator in every record (detects drift early) - **No proxy needed** — Grailed uses a public Algolia search key by design - **Key-rotation fallback** — if the hardcoded Algolia key rotates, the actor fetches a fresh key from the Grailed homepage automatically and retries - **Client-side filters** — designerFilter, categoryFilter, sizeFilter for targeted collection ### How it works Grailed's search is powered by Algolia and uses a **public, intentionally exposed search-only API key** embedded in `window.PUBLIC_CONFIG` on every Grailed page load. This is by design — the same key powers the site's search UI. The Algolia endpoint (`*.algolia.net`) has no Cloudflare protection. #### Key-rotation durability The hardcoded Algolia key is extracted once: ```` app\_id: MNRWEFSS2Q api\_key: c89dbaddf15fe70e1941a109bf7c2a3d (as of 2026-05-31) index: Listing\_production ```` If this key ever rotates and returns HTTP 403, the actor automatically: 1. Fetches `https://www.grailed.com` via curl_cffi (Chrome fingerprint) 2. Extracts the fresh key via `publicSearchKey` regex from `window.PUBLIC_CONFIG` 3. Retries the search with the fresh credentials This makes the actor self-healing against key rotations without any manual update. ### Input | Field | Type | Default | Description | |---|---|---|---| | `searchQuery` | string | required | Keyword(s) to search (e.g. "nike vintage jacket") | | `maxItems` | integer | 100 | Max listings to return (1–10,000) | | `designerFilter` | string | "" | Filter by designer name (partial, case-insensitive) | | `categoryFilter` | string | "" | Filter by category (partial, case-insensitive) | | `sizeFilter` | string | "" | Filter by size (exact, case-insensitive) | ### Output fields | Field | Type | Description | |---|---|---| | `listing_id` | int | Grailed numeric listing ID | | `title` | string | Listing title | | `price` | float | Current asking price (USD) | | `price_drops` | list | Price drop history (descending) | | `condition` | string | `"new"` / `"new_with_tags"` / `"used"` | | `designers` | string | Comma-separated designer names | | `category` | string | Top-level category (e.g. `"outerwear"`) | | `category_path` | string | Full category path (e.g. `"outerwear.bombers"`) | | `size` | string | Size string (e.g. `"xl"`, `"32"`) | | `color` | string | Primary color | | `sold` | bool | True if sold | | `sold_price` | float | Final sale price (null if not sold) | | `seller_username` | string | Grailed seller username | | `seller_score` | float | Seller rating average (0–5) | | `seller_reviews` | int | Number of seller reviews | | `cover_photo` | string | Cover photo image URL | | `location` | string | Seller location | | `marketplace` | string | `"grailed"` / `"hbx"` / etc. | | `strata` | string | `"hype"` / `"luxury"` / `"sartorial"` / `"basic"` | | `listing_url` | string | Canonical Grailed listing URL | | `created_at` | string | ISO 8601 UTC listing creation time | | `scraped_at` | string | ISO 8601 UTC when this run started | | `parse_confidence` | float | Data quality score 0–1 | | `warnings` | list | Quality warning codes (e.g. `["price_missing"]`) | ### Sample output record ```json { "listing_id": 97807015, "title": "Nike x Off White Virgil Abloh Air Max 90 Brand New", "price": 400.0, "price_drops": [], "condition": "new", "designers": "Nike", "category": "footwear", "category_path": "footwear.lowtop_sneakers", "size": "10", "color": "white", "sold": false, "sold_price": null, "seller_username": "luxcollector", "seller_score": 4.993, "seller_reviews": 146, "cover_photo": "https://media-assets.grailed.com/prd/listing/temp/9d13f47b437549a69008a0baa5885421", "location": "United States", "marketplace": "grailed", "strata": "hype", "listing_url": "https://www.grailed.com/listings/97807015", "created_at": "2026-05-31T15:47:24.368Z", "scraped_at": "2026-05-31T15:48:53Z", "parse_confidence": 1.0, "warnings": [] } ```` ### Use cases - **Market research** — track prices and sold data for specific brands or items - **Price monitoring** — collect price\_drops history to find deals - **Resale arbitrage** — compare Grailed prices vs other platforms - **Trend analysis** — track which categories and designers are trending (strata field) - **Seller research** — filter by seller\_score for high-quality sources ### Technical notes - Grailed uses Algolia's `Listing_production` index with ~250k+ active listings - Results are sorted by `price_updated_at` (default Algolia sort for this index) - No login or proxy required — this is Grailed's own public search infrastructure - The actor fetches 48 listings per page (Algolia max for this index) ### Resale arbitrage example Compare `sold_price` vs `price` to find underpriced listings: - `sold_price: 320` + `price: 200` → $120 spread on a Jordan 1 - Use `strata: "hype"` filter to target the most liquid resale segment ### vs. competitors | Feature | This actor | epctex/grailed-scraper (HTML) | |---|---|---| | Data source | Official Algolia API (public) | HTML scraping | | price\_drops history | Yes | No | | sold\_price (comp data) | Yes | Rarely | | strata field (hype/luxury) | Yes | No | | Key rotation fallback | Self-healing | Hard-coded (breaks on key change) | | Price | $1.50/1K active, $2.50/1K sold | $3–5/1K flat | ### parse\_confidence trust signal Every record ships a `parse_confidence` score (0.0–1.0). Detects Algolia schema drift early. ### Use with AI agents (MCP) This actor is tagged `MCP_SERVERS` — compatible with Claude, GPT-4o, and other MCP-aware agents: ``` https://mcp.apify.com/?tools=bovi/grailed-listings ``` ### Pricing example | Volume | Mode | Cost | |---|---|---| | 100 listings | Active | $0.15 | | 1,000 listings | Active | $1.50 | | 100 listings | Sold (with sold\_price) | $0.25 | | 1,000 listings | Sold (with sold\_price) | $2.50 | First 10 results are free. Active vs sold routing happens automatically — sold items with a confirmed `sold_price` use the $2.50/1K rate. ### FAQ **Do I need a proxy or login?** No. Grailed search runs on a public Algolia endpoint — no proxy, no login, no credentials required. **What if the Algolia key changes?** The actor self-heals: if the hardcoded key returns a 403, it fetches a fresh key from the Grailed homepage automatically and retries. No manual update needed. **What output formats are available?** JSON (default), CSV, and Excel — via the Apify dataset export or API. **What if search returns empty?** Try a broader keyword. Algolia's Grailed index has ~250k+ active listings. Misspellings and very niche terms return empty — use partial brand names (e.g. "Nike" not "Nike Off-White Collab Limited"). ### Pricing Two-tier pay-per-result: - **$1.50/1K** — active listings (price, condition, designer, size) - **$2.50/1K** — sold listings with confirmed `sold_price` (comp data for arbitrage) No proxy costs. No COGS. ### Integrations Built for streetwear resellers running arbitrage across Grailed, StockX, and eBay, plus analysts tracking secondary-market trends — the JSON/dataset output drops into the tools you already run, no glue code: - **n8n / Make / Zapier** — trigger a run or pipe every new dataset item into 500+ apps (Google Sheets, Airtable, Slack, HubSpot, your database) with no code: [n8n](https://docs.apify.com/platform/integrations/n8n), [Make](https://docs.apify.com/platform/integrations/make), [Zapier](https://docs.apify.com/platform/integrations/zapier). - **Webhooks** — fire your own endpoint the moment a run finishes, to push results straight into your pipeline ([docs](https://docs.apify.com/platform/integrations/webhooks)). - **MCP server** — expose this actor as a tool to Claude, Cursor, or any [MCP client](https://mcp.apify.com) so an AI agent can pull this data mid-conversation ([guide](https://blog.apify.com/how-to-use-mcp/)). - **API & SDKs** — fetch the dataset as JSON, CSV, or Excel through the Apify REST API or the Python / JS SDKs. See all [Apify integrations](https://apify.com/integrations). # Actor input Schema ## `searchQuery` (type: `string`): Keyword(s) to search Grailed listings (e.g. 'nike vintage jacket', 'acne studios', 'arc teryx'). Required. ## `maxItems` (type: `integer`): Maximum number of listings to return (1–10000). Algolia returns 48 per page. Default 100. ## `designerFilter` (type: `string`): Filter by designer name (e.g. 'Nike', 'Supreme', 'Rick Owens'). Case-insensitive partial match applied client-side. Leave blank for all. ## `categoryFilter` (type: `string`): Filter by category (e.g. 'outerwear', 'footwear', 'tops'). Case-insensitive partial match. Leave blank for all. ## `sizeFilter` (type: `string`): Filter by size (e.g. 'xl', 'l', '32', '10'). Case-insensitive exact match. Leave blank for all. ## Actor input object example ```json { "searchQuery": "nike vintage jacket", "maxItems": 100 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQuery": "nike vintage jacket", "maxItems": 100, "designerFilter": "", "categoryFilter": "", "sizeFilter": "" }; // Run the Actor and wait for it to finish const run = await client.actor("bovi/grailed-listings").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQuery": "nike vintage jacket", "maxItems": 100, "designerFilter": "", "categoryFilter": "", "sizeFilter": "", } # Run the Actor and wait for it to finish run = client.actor("bovi/grailed-listings").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQuery": "nike vintage jacket", "maxItems": 100, "designerFilter": "", "categoryFilter": "", "sizeFilter": "" }' | apify call bovi/grailed-listings --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/grailed-listings", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Grailed Scraper — Streetwear Resale & Sold Prices | $1.50/1K", "description": "Search Grailed resale listings via the public Algolia API. Returns price, price_drops, sold_price, condition, designer, size, strata (hype/luxury), seller score. Two-tier PPE: $1.50/1K active, $2.50/1K sold listings with confirmed prices. No proxy. Pay per result.", "version": "0.1", "x-build-id": "Ar9ukYWvm12hjkN56" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~grailed-listings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-grailed-listings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/bovi~grailed-listings/runs": { "post": { "operationId": "runs-sync-bovi-grailed-listings", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/bovi~grailed-listings/run-sync": { "post": { "operationId": "run-sync-bovi-grailed-listings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "searchQuery" ], "properties": { "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword(s) to search Grailed listings (e.g. 'nike vintage jacket', 'acne studios', 'arc teryx'). Required." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of listings to return (1–10000). Algolia returns 48 per page. Default 100." }, "designerFilter": { "title": "Designer filter", "type": "string", "description": "Filter by designer name (e.g. 'Nike', 'Supreme', 'Rick Owens'). Case-insensitive partial match applied client-side. Leave blank for all." }, "categoryFilter": { "title": "Category filter", "type": "string", "description": "Filter by category (e.g. 'outerwear', 'footwear', 'tops'). Case-insensitive partial match. Leave blank for all." }, "sizeFilter": { "title": "Size filter", "type": "string", "description": "Filter by size (e.g. 'xl', 'l', '32', '10'). Case-insensitive exact match. Leave blank for all." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```