{ "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": "0zyUegaCi1o9XSGVi" }, "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 shop, category, designer, or search-results URLs straight from your browser. Any filters in the URL (department, brand, price, etc.) 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_very_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 } } } } } } } } } }