{ "openapi": "3.0.1", "info": { "title": "Grailed Scraper", "description": "[💰 $3.0 / 1K] Extract Grailed fashion listings — price, designer, size, condition, seller, and images. Search by keyword or paste Grailed URLs; filter by price, department, and condition; optionally pull full listing details.", "version": "1.0", "x-build-id": "LIGG2XNB4NcwN2kX4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~grailed-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-grailed-scraper", "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/solidcode~grailed-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-grailed-scraper", "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/solidcode~grailed-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-grailed-scraper", "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", "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Keywords to search on Grailed, such as designer names, item types, or styles (e.g. 'rick owens ramones', 'jordan 1'). Each query produces its own set of results.", "items": { "type": "string" } }, "startUrls": { "title": "Grailed URLs", "type": "array", "description": "Paste Grailed search, designer, curated shop (for example /shop/footwear) or saved-search URLs straight from your browser. Filters carried by the URL, or stored behind a curated or saved-search link, are applied automatically.", "items": { "type": "string" } }, "maxResults": { "title": "Max Results per Query", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to collect per search query or URL. Grailed returns up to 1,000 results per search. Set to 0 to collect up to that limit.", "default": 100 }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "newest", "price_asc", "price_desc", "popular" ], "type": "string", "description": "Order in which listings are returned.", "default": "relevance" }, "department": { "title": "Department", "enum": [ "all", "menswear", "womenswear" ], "type": "string", "description": "Limit results to menswear or womenswear, or include both.", "default": "all" }, "condition": { "title": "Condition", "uniqueItems": true, "type": "array", "description": "Only include listings in these condition buckets. Leave empty for any condition.", "items": { "type": "string", "enum": [ "is_new", "is_gently_used", "is_used", "is_worn" ], "enumTitles": [ "New / Never Worn", "Gently Used", "Used", "Very Worn" ] }, "default": [] }, "minPrice": { "title": "Minimum Price (USD)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or above this amount, in US dollars." }, "maxPrice": { "title": "Maximum Price (USD)", "minimum": 0, "type": "integer", "description": "Only include listings priced at or below this amount, in US dollars." }, "includeDetails": { "title": "Include Full Listing Details", "type": "boolean", "description": "Fetch each listing's full page to add the complete description, every photo, and extra seller details (location, rating, listing count). Slower and returns more data per listing. Detail enrichment is best-effort: if Grailed is blocking detail pages, the run still returns every listing's core fields (title, price, designer, size, condition, image) and just leaves the extra detail fields empty for the listings it couldn't load.", "default": false } } }, "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 } } } } } } } } } }