{ "openapi": "3.0.1", "info": { "title": "Nike Product Catalog, Colorway & Price Scraper", "description": "Search Nike.com by keyword or style code, browse 40 shoe/clothing categories across 18 marketplaces, or fetch full product-page detail including sizes, stock status and every colorway of a style.", "version": "1.0", "x-build-id": "37MRgzu9wsaOALrOH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/vexaloom-labs~nike-product-catalog-colorway-and-price-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-vexaloom-labs-nike-product-catalog-colorway-and-price-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/vexaloom-labs~nike-product-catalog-colorway-and-price-scraper/runs": { "post": { "operationId": "runs-sync-vexaloom-labs-nike-product-catalog-colorway-and-price-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/vexaloom-labs~nike-product-catalog-colorway-and-price-scraper/run-sync": { "post": { "operationId": "run-sync-vexaloom-labs-nike-product-catalog-colorway-and-price-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "browseCategory", "productDetails", "startUrls" ], "type": "string", "description": "What to fetch. `startUrls` auto-detects each pasted Nike search, category or product URL and overrides the other modes when provided.", "default": "search" }, "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more keywords, product names or style codes (e.g. `air max`, `dunk low`, `CW2288-111`). Used with mode=search.", "items": { "type": "string" }, "default": [ "air max" ] }, "country": { "title": "Marketplace / country", "enum": [ "US", "GB", "DE", "FR", "JP", "MX", "ES", "IT", "NL", "SE", "KR", "SG", "TH", "TW", "ID", "PH", "MY", "ZA" ], "type": "string", "description": "Nike storefront market for search, category browsing and non-prefixed URLs. Prices are returned in the marketplace's local currency.", "default": "US" }, "category": { "title": "Category (mode=browseCategory)", "enum": [ "accessoriesEquipment", "acgShoes", "babyToddlerShoes", "bigKidsShoes", "littleKidsShoes", "mensBagsBackpacks", "mensBasketballShoes", "mensClothing", "mensHatsVisors", "mensHoodiesPullovers", "mensJacketsVests", "mensJordanShoes", "mensLifestyleShoes", "mensPantsTights", "mensRunningShoes", "mensSaleShoes", "mensShoes", "mensShorts", "mensSoccerShoes", "mensSocks", "mensTrainingGymShoes", "newMensShoes", "newWomensShoes", "sale", "womensBagsBackpacks", "womensBasketballShoes", "womensClothing", "womensHatsVisors", "womensHoodiesPullovers", "womensJacketsVests", "womensJordanShoes", "womensLifestyleShoes", "womensPantsTights", "womensRunningShoes", "womensSaleShoes", "womensShoes", "womensShorts", "womensSoccerShoes", "womensSocks", "womensTrainingGymShoes" ], "type": "string", "description": "Curated Nike catalog category to browse. Works in every supported country; pass several categories by using `startUrls` with category links instead." }, "startUrls": { "title": "Nike search, category or product URLs", "type": "array", "description": "Paste any nike.com search (`/w?q=...`), category (`/w/...`) or product (`/t/...` or `/u/...`) URLs. Locale-prefixed links such as `nike.com/gb/t/...` set the marketplace automatically. When supplied, these URLs override `mode`.", "items": { "type": "object", "properties": { "url": { "type": "string", "title": "URL", "description": "A nike.com search, category or product URL." } }, "required": [ "url" ] }, "default": [] }, "productUrls": { "title": "Product URLs (mode=productDetails)", "type": "array", "description": "Full Nike.com product page URLs, e.g. `https://www.nike.com/t/air-force-1-07-mens-shoes-jBrhbr/CW2288-111`. `/u/` Nike By You URLs are accepted too.", "items": { "type": "string" }, "default": [] }, "styleCodes": { "title": "Style codes (mode=productDetails)", "type": "array", "description": "Nike style or style-color codes, e.g. `CW2288-111` or `CW2288`. The actor resolves each code to its Nike product page and returns full detail. For Nike By You products use the 10-digit style-color code (e.g. `6484638358`).", "items": { "type": "string" }, "default": [] }, "minPrice": { "title": "Min price", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced below this amount (current price, in the marketplace's currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Drop products priced above this amount (current price, in the marketplace's currency)." }, "minDiscount": { "title": "Minimum discount %", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only products discounted by at least this percentage. 0 disables the filter.", "default": 0 }, "onSaleOnly": { "title": "On sale only", "type": "boolean", "description": "Only emit products with an active discount.", "default": false }, "includeAllColorways": { "title": "Include all colorways", "type": "boolean", "description": "By default only the representative colorway shown on Nike's grid is emitted per style. Enable to emit every available colorway as its own record, each with its own real price, color, image and product URL.", "default": false }, "includeProductDetails": { "title": "Add product-page details to listings", "type": "boolean", "description": "For search, category and URL modes, fetch each listed product's detail page and add description, features, sizes, stock, images and all colorways. Adds one HTTP request per emitted record.", "default": false }, "includeReviews": { "title": "Include review summary", "type": "boolean", "description": "Add the product's rating, review count, AI review summary and the three most recent reviews. Applies to product details, or to listings when `includeProductDetails` is enabled.", "default": false }, "gender": { "title": "Gender", "enum": [ "ANY", "MEN", "WOMEN" ], "type": "string", "description": "Filter to a single gender facet in search and pasted search URLs. Not supported by Nike's API for country=TH or TW; ignored there.", "default": "ANY" }, "productType": { "title": "Product type", "enum": [ "ANY", "FOOTWEAR", "APPAREL", "ACCESSORIES", "EQUIPMENT" ], "type": "string", "description": "Filter to a single Nike product type.", "default": "ANY" }, "attributeFilter": { "title": "Featured attribute", "enum": [ "ANY", "NEW", "COMING_SOON", "BEST_SELLER", "SUSTAINABLE_MATERIALS" ], "type": "string", "description": "Keep only products carrying a specific Nike merchandising tag. Applies to search, category and URL modes.", "default": "ANY" }, "filters": { "title": "Nike facet filters", "type": "array", "description": "Optional Nike facet labels, exactly as shown in the site's filter panel. Use `Group: Value` for an exact group, e.g. `Sports: Running`, `Color: Black`, `Brand: Nike`, `Width: Wide`, `Size: 10`, or a bare value such as `Running`. Unknown labels are skipped with a log warning.", "items": { "type": "string" }, "default": [] }, "sortBy": { "title": "Sort by", "enum": [ "featured", "newest", "priceLowToHigh", "priceHighToLow", "discountHighToLow" ], "type": "string", "description": "Order results. Nike's public wall API has no reliable server-side sort, so the actor sorts the fetched records locally.", "default": "featured" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap on emitted records across all queries, categories and URLs.", "default": 24 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }