# Nike Product Scraper (`sian.agency/nike-product-scraper`) Actor Scrape Nike products โ€” USD prices, discounts, colourways, images, sizes & availability. Keyword search or paste a nike.com wall URL, full detail enrichment, clean JSON/CSV, no code. - **URL**: https://apify.com/sian.agency/nike-product-scraper.md - **Developed by:** [SIรN Oรœ](https://apify.com/sian.agency) (community) - **Categories:** E-commerce, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 overview product extracteds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Nike Product Scraper โ€“ Prices, Discounts, Sizes & Stock ๐Ÿ‘Ÿ [![SIรN Agency Store](https://img.shields.io/badge/Store-SI%C3%81N%20Agency-1AE392)](https://apify.com/sian.agency?fpr=sian) [![Best Buy Product Scraper](https://img.shields.io/badge/Store-Best%20Buy%20Product%20Scraper-0046BE)](https://apify.com/sian.agency/best-buy-product-scraper?fpr=sian) [![Amazon Product Scraper](https://img.shields.io/badge/Store-Amazon%20Product%20Scraper-FF9900)](https://apify.com/sian.agency/amazon-product-scraper?fpr=sian) [![Google Shopping Price Scraper](https://img.shields.io/badge/Store-Google%20Shopping%20Price%20Scraper-4285F4)](https://apify.com/sian.agency/google-shopping-price-scraper?fpr=sian) #### ๐ŸŽ‰ Scrape any Nike search or product wall into a clean dataset โ€” USD prices, discounts, every colourway, per-size stock & GTIN barcodes ##### Built for sneaker resellers, retail analysts, price-monitoring teams and market researchers who need live Nike product data at scale --- ### ๐Ÿ“‹ Overview **Turn any nike.com search or category wall into a structured product feed in minutes** โ€” no account, no API key, no code. Just type a keyword like `air max` (or paste a Nike URL) and get back clean JSON, CSV or Excel with prices, discounts, colourways, sizes and live availability. **Why thousands of professionals choose us:** - โœ… **Real Nike catalog data**: Pulls straight from Nike's own product walls โ€” the exact prices, discounts and stock a US shopper sees, in USD - โšก **Fast at scale**: A single wall page returns ~150โ€“200 style-colors โ€” sweep whole categories in one run - ๐ŸŽฏ **Every colourway, every size**: Detail mode returns per-size availability with GTIN barcodes, all colourways, and the full image gallery - ๐Ÿ’ฐ **Pay-per-result pricing**: Only pay for products you actually receive โ€” plus a free tier to try it risk-free - ๐Ÿ’Ž **Two depths, one clean record**: Fast Overview for wide scans, rich Detail for full spec โ€” merged into a single row per product, no stitching - โœจ **NEW**: Native Nike filters โ€” sort and narrow by gender, sport, colour, size and price band, exactly like the site's own facets --- ### โœจ Features - ๐Ÿ” **Keyword & URL Search**: Search Nike by free-text keyword (`dunk low`, `tech fleece`) or paste any nike.com wall or product URL - ๐Ÿ‘Ÿ **Style-Color Precision**: One record per buyable style-color, with the colourway count that shares each product card - ๐Ÿท๏ธ **Complete Pricing Data**: Current price, full/was price, discount percentage and currency (USD) โ€” ready for price monitoring and repricing - ๐Ÿ“ **Per-Size Availability**: Detail mode returns every size, its stock status, localized label and GTIN barcode - ๐ŸŒˆ **All Colourways**: Capture every colourway of a product โ€” code, colour, image, price and availability - ๐Ÿ–ผ๏ธ **Full Image Galleries**: Primary thumbnail plus the complete product image set - ๐Ÿงญ **Rich Taxonomy**: Gender, sport tags, category and Nike's full Brand/Gender/Sports/Collections taxonomy - ๐Ÿ”ƒ **Native Sorting & Filters**: Featured, Newest, Price lowโ†’high / highโ†’low, plus gender, sport, colour, size and price-band facets - ๐Ÿ“ฆ **Export Ready**: Clean JSON, CSV and Excel straight from the Apify dataset - ๐ŸŽ **Free Tier Included**: Test the full feature set with no credit card --- ### ๐ŸŽฌ Quick Start Enter a keyword (or paste a Nike URL), pick a mode, and click **Run**. Results stream into the dataset as they're scraped and are ready to export as JSON, CSV or Excel. ```bash curl -X POST "https://api.apify.com/v2/acts/sian.agency~nike-product-scraper/runs?token=YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"queries": ["air max"], "scrapeMode": "overview", "maxResults": 100}' ```` *** ### ๐Ÿš€ Getting Started (3 Simple Steps) #### Step 1: Enter your search Add one or more keywords (e.g. `air force 1`, `running shoes`) โ€” or paste full nike.com wall URLs for pixel-perfect filtering. #### Step 2: Choose your depth Pick **Overview** for a fast, wide scan or **Detail** for the full spec โ€” sizes, description, colourways and taxonomy. #### Step 3: Run and export Click **Run**. Watch products fill the dataset live, then download as JSON, CSV or Excel. **That's it! In a few minutes, you'll have:** - A clean, deduplicated product feed with live USD prices - Discounts, colourway counts and availability for every item - Full size, image and taxonomy data (in Detail mode) *** ### ๐Ÿ“ฅ Input Configuration | Field | Type | Required | Description | |-------|------|----------|-------------| | `queries` | array | No\* | Free-text Nike searches (e.g. `air max`, `dunk`). One per line. | | `scrapeMode` | string | No | `overview` (fast wall) or `detail` (sizes + description + colourways). Default `overview`. | | `sort` | string | No | `featured`, `newest`, `price_low`, `price_high`. | | `gender` | string | No | Nike gender facet (e.g. `Men`, `Women`, `Unisex`). | | `sport` | string | No | Nike activity facet (e.g. `Running`, `Basketball`, `Lifestyle`). | | `color` | string | No | Nike colour facet (e.g. `Black`, `White`, `Blue`). | | `size` | string | No | Nike size label (e.g. `10`, `M 10 / W 11.5`, `L`). | | `price` | string | No | Nike "Shop by Price" band (e.g. `$100 - $150`, `Over $150`). | | `urls` | array | No\* | Paste nike.com wall (`/w/โ€ฆ`) or product (`/t/โ€ฆ`) URLs to scrape verbatim. | | `maxResults` | integer | No | Cap on products returned (FREE: 25, PAID: unlimited). Default 200. | \* Provide at least one `queries` entry **or** one `urls` entry. **Example โ€” keyword search, Overview:** ```json { "queries": ["air max", "dunk low"], "scrapeMode": "overview", "sort": "newest", "maxResults": 200 } ``` **Example โ€” filtered wall, Detail:** ```json { "urls": ["https://www.nike.com/w/mens-shoes-nik1zy7ok"], "scrapeMode": "detail", "color": "Black", "price": "$100 - $150", "maxResults": 50 } ``` *** ### ๐Ÿ“ค Output Results are saved to the Apify dataset with **32+ fields** including: | Field | Type | Description | |-------|------|-------------| | `product_id` | string | Style-color code (e.g. `CW2288-111`) โ€” the unique buyable id | | `productTitle` | string | Full product name (e.g. Nike Air Force 1 '07) | | `subtitle` | string | Short descriptor (e.g. Men's Shoes) | | `price` | number | Current price (USD) | | `full_price` | number | Full / was price before discount | | `discount_percentage` | number | Percentage off the full price | | `colorway_count` | integer | Colourways sharing this product card | | `available` | boolean | Whether the product is purchasable | | `product_type` | string | FOOTWEAR / APPAREL / EQUIPMENT | | `sizes` | array | Per-size availability with status + GTIN (detail) | | `colorways` | array | Every colourway: code, colour, image, price (detail) | | `images` | array | Full product image gallery | | `description` | string | Long product description (detail) | | `gender` / `sport_tags` / `taxonomy` | array/object | Gender, sport and full Nike taxonomy (detail) | | `url` / `thumbnail` | string | Product page link and primary image | **Example (detail record, trimmed):** ```json { "thumbnail": "https://static.nike.com/a/images/.../air-force-1-07.png", "product_id": "CW2288-111", "productTitle": "Nike Air Force 1 '07", "subtitle": "Men's Shoes", "source": "detail", "product_type": "FOOTWEAR", "brand": "Nike", "color": "White/White", "price": 115, "full_price": 115, "discount_percentage": 0, "currency": "USD", "colorway_count": 3, "available": true, "sizes": [ { "label": "5", "localized_label": "M 5 / W 6.5", "status": "ACTIVE", "in_stock": true, "gtin": "00194500874862" } ], "gender": ["MEN"], "sport_tags": ["Lifestyle", "Dance"], "category": "Shoes", "url": "https://www.nike.com/t/air-force-1-07-mens-shoes-jBrhbr/CW2288-111" } ``` *** ### ๐Ÿ’ผ Use Cases & Examples #### 1. Sneaker Reseller Price & Drop Monitoring **Resellers tracking release prices, discounts and restocks across Nike's catalog.** **Input:** Keywords or wall URLs for the models you flip **Output:** Live USD price, was-price, discount %, and per-size stock **Use:** Spot markdowns and sold-out sizes the moment they change. #### 2. Retail & Competitor Pricing Intelligence **Retail analysts benchmarking assortment and pricing against Nike direct.** **Input:** Category walls (men's/women's shoes, apparel) **Output:** Full assortment with prices and discount depth **Use:** Feed repricing models and margin analysis. #### 3. Catalog & Assortment Research **Merchandisers mapping Nike's live range by sport, gender and colour.** **Input:** Filtered walls by gender/sport/colour **Output:** Structured catalog with colourway counts and taxonomy **Use:** Understand breadth, newness and colour strategy at a glance. #### 4. Size & Stock Availability Checks **Ops teams that need per-size availability at scale.** **Input:** Detail mode over your target products **Output:** Every size, its stock status and GTIN barcode **Use:** Track sell-through and identify restock opportunities. #### 5. Colourway Tracking **Sneaker media and enthusiasts cataloguing every colourway of a silhouette.** **Input:** A model keyword (e.g. `dunk low`) in Detail mode **Output:** All colourways with codes, images and prices **Use:** Build complete colourway galleries and databases. #### 6. Market & Demand Research **Analysts studying price bands, discount patterns and new-arrival velocity.** **Input:** Sorted walls (Newest, Price) across categories **Output:** Time-stamped product records for trend analysis **Use:** Quantify discounting and drop cadence over time. *** ### ๐Ÿ”— Integration Examples #### JavaScript/Node.js ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_TOKEN' }); const run = await client.actor('sian.agency/nike-product-scraper').call({ queries: ['air max'], scrapeMode: 'overview', maxResults: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items[0]); ``` #### Python ```python from apify_client import ApifyClient client = ApifyClient('YOUR_TOKEN') run = client.actor('sian.agency/nike-product-scraper').call( run_input={'queries': ['air max'], 'scrapeMode': 'detail', 'maxResults': 25} ) for item in client.dataset(run['defaultDatasetId']).iterate_items(): print(item) ``` #### cURL ```bash curl -X POST 'https://api.apify.com/v2/acts/sian.agency~nike-product-scraper/runs?token=YOUR_TOKEN' \ -H 'Content-Type: application/json' \ -d '{"queries": ["dunk low"], "scrapeMode": "overview"}' ``` #### Automation Workflows (N8N / Zapier / Make) 1. **Trigger**: Schedule (e.g. hourly price checks) or webhook 2. **HTTP Request**: Call the actor API 3. **Process**: Handle the JSON product records 4. **Action**: Save to a sheet/DB, alert on price drops, or sync to your catalog *** ### ๐Ÿ“Š Performance & Pricing #### FREE Tier (Try It Now) - **25 products** per run โ€” full feature access, same data quality - No credit card required - Perfect for testing keywords and small projects #### PAID Tier (Production Ready) - **Unlimited** products per run โ€” sweep entire walls in one go - Pay-per-result: only charged for products you actually receive ๐Ÿ’ฐ **Transparent pay-per-result pricing** โ€” a small base fee per run plus a low per-product rate; Detail rows (full sizes + description + colourways) are priced above fast Overview rows. ๐Ÿ”— [View current pricing](https://apify.com/sian.agency/nike-product-scraper?fpr=sian) *** ### โ“ Frequently Asked Questions **Q: How many products can I scrape?** A: FREE tier: 25 per run. PAID tier: unlimited. A single wall page yields ~150โ€“200 style-colors. **Q: What's the difference between Overview and Detail?** A: Overview is a fast wall scan (id, name, price, discount, colourway count, image, availability). Detail adds the long description, per-size availability with GTINs, the full image gallery, every colourway, gender, sport and full taxonomy. **Q: Which prices do I get?** A: The live US-marketplace prices in USD โ€” current price, full/was price and discount percentage. **Q: What output formats are available?** A: JSON, CSV and Excel โ€” export directly from the Apify dataset. **Q: Can I filter like the Nike site?** A: Yes โ€” sort by featured/newest/price, and narrow by gender, sport, colour, size and price band using Nike's own facets. Or paste a fully-filtered nike.com URL. **Q: Do I need a Nike account or API key?** A: No โ€” just enter a keyword or URL and click Run. **Q: Is this legal?** A: We only extract publicly available product data. See the legal note below. *** ### ๐Ÿ› Troubleshooting **No products returned** - Check the keyword returns results on nike.com, or that a pasted URL is a valid `/w/` wall or `/t/` product page - Lower `maxResults` while testing, then raise it **A filter had no effect** - Facet values must match Nike's own labels (e.g. `$100 - $150`, not `100-150`). Pasting a filtered nike.com URL is the most reliable way to apply complex filters **Fewer products than expected** - FREE tier is capped at 25 per run โ€” upgrade to PAID for unlimited - Very specific filters naturally return smaller walls *** ### โš–๏ธ Is it legal to scrape data? Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what is published publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe. However, you should be aware that your results could contain personal data. Personal data is protected by the **GDPR** in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. You can also read Apify's blog post on the [legality of web scraping](https://blog.apify.com/is-web-scraping-legal/). **Trademark disclaimer:** *Nike* and all related names, marks and the swoosh are trademarks of Nike, Inc. This actor is an independent tool and is **not** affiliated with, authorized, sponsored or endorsed by Nike, Inc. It accesses only publicly available product information. All product data and trademarks belong to their respective owners. *** ### ๐Ÿค Support [![Telegram Support](https://img.shields.io/badge/Telegram-Support%20Group-0088cc?logo=telegram)](https://t.me/+vyh1sRE08sAxMGRi) **Join our active support community** - For issues or questions, open an issue in the actor's repository - Check [SIรN Agency Store](https://apify.com/sian.agency?fpr=sian) for more automation tools - ๐Ÿ“ง *** **Built by [SIรN Agency](https://www.sian-agency.online)** | **[More Tools](https://apify.com/sian.agency?fpr=sian)** # Actor input Schema ## `queries` (type: `array`): ๐Ÿ” **KEYWORD SEARCH:** Free-text Nike searches โ€” exactly what you'd type into nike.com's search bar. ๐Ÿ“ **EXAMPLES:** `air max` ยท `air force 1` ยท `running shoes` ยท `tech fleece` ยท `dunk low` ๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset. ๐Ÿ–Š๏ธ **BULK EDIT:** Click "Bulk edit" to paste many keywords at once (one per line). โœ… **IMPORTANT:** Provide either keywords OR Nike product-wall URLs (at least one is needed to have something to scrape). ## `scrapeMode` (type: `string`): โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product. โšก **Overview (fast):** Product-wall results only โ€” style-color ID, name, subtitle, USD price, full/was price, discount %, colourway count, image, badge and availability. Fastest and cheapest path. ๐Ÿ”ฌ **Detail (sizes + description + colourways):** Everything in Overview PLUS the long product description, per-size availability (with GTIN barcodes), the full image gallery, every colourway, gender, sport tags and the full taxonomy โ€” scraped from each product page. ๐Ÿ’ก **TIP:** Start with Overview to scope a wall, then switch to Detail when you need sizes and full descriptions. ## `sort` (type: `string`): ๐Ÿ”ƒ **RESULT ORDERING:** Order wall results using Nike's own native sort options โ€” the same ranking real shoppers see. โญ **Featured** is Nike's default relevance order ยท ๐Ÿ†• **Newest** leads with the latest drops ยท ๐Ÿ’ฒ **Price** sorts ascending or descending. ## `gender` (type: `string`): ๐Ÿšป **GENDER FILTER:** Restrict to Nike's own gender facet (e.g. `Men`, `Women`, `Unisex`, `Boys`, `Girls`). Resolved against the live wall facets, so it mirrors the site's filter. ๐Ÿ’ก **TIP:** Leave blank to include all. ## `sport` (type: `string`): ๐Ÿ€ **SPORT / ACTIVITY FILTER:** Nike's activity facet (e.g. `Running`, `Basketball`, `Lifestyle`, `Training & Gym`, `Football`). Leave blank for all. ## `color` (type: `string`): ๐ŸŽจ **COLOUR FILTER:** Nike's colour facet (e.g. `Black`, `White`, `Blue`, `Red`, `Grey`). Leave blank for all. ## `size` (type: `string`): ๐Ÿ“ **SIZE FILTER:** A Nike size label as shown on the wall (e.g. `10`, `M 10 / W 11.5`, `M`, `L`). Leave blank for all sizes. ## `price` (type: `string`): ๐Ÿ’ฒ **PRICE BAND FILTER:** A Nike "Shop by Price" band label (e.g. `$0 - $50`, `$50 - $100`, `$100 - $150`, `Over $150`). Must match Nike's band label exactly. Leave blank for all prices. ## `urls` (type: `array`): ๐Ÿ”— **PASTE PRODUCT-WALL URLs:** Paste full nike.com wall or search URLs to scrape them verbatim โ€” any filters and sorting already in the URL are preserved (a fully-filtered nike.com URL is the most complete filter interface). ๐Ÿ“ **EXAMPLES:** `https://www.nike.com/w/mens-shoes-nik1zy7ok` ยท `https://www.nike.com/w?q=dunk` ๐Ÿ”ฌ **DETAIL MODE:** You can also paste individual product-page URLs (`https://www.nike.com/t/...`) โ€” in Detail mode they're scraped directly. ๐Ÿ–Š๏ธ **BULK EDIT:** Add one URL per line to sweep several walls in a single run. ## `maxResults` (type: `integer`): ๐Ÿ”ข **RESULT CAP:** Maximum number of products (style-colors) to return across all keywords and URLs combined. ๐ŸŽ **TIER-BASED LIMITS:** - **FREE users:** Up to 25 products per run - **PAID users:** Unlimited โ€” scrape whole walls in a single run ๐Ÿ’ก **TIP:** A single wall page yields ~150โ€“200 style-colors, so keep this low while you dial in your search, then raise it once the output looks right. ## Actor input object example ```json { "queries": [ "air max" ], "scrapeMode": "overview", "sort": "featured", "maxResults": 200 } ``` # Actor output Schema ## `nikeProducts` (type: `string`): Scraped Nike products with prices, discounts, colourways, images, sizes and availability. # 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 = { "queries": [ "air max" ] }; // Run the Actor and wait for it to finish const run = await client.actor("sian.agency/nike-product-scraper").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 = { "queries": ["air max"] } # Run the Actor and wait for it to finish run = client.actor("sian.agency/nike-product-scraper").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 '{ "queries": [ "air max" ] }' | apify call sian.agency/nike-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sian.agency/nike-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Nike Product Scraper", "description": "Scrape Nike products โ€” USD prices, discounts, colourways, images, sizes & availability. Keyword search or paste a nike.com wall URL, full detail enrichment, clean JSON/CSV, no code.", "version": "1.0", "x-build-id": "9c1ilP5NQM93HFHm6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sian.agency~nike-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sian.agency-nike-product-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/sian.agency~nike-product-scraper/runs": { "post": { "operationId": "runs-sync-sian.agency-nike-product-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/sian.agency~nike-product-scraper/run-sync": { "post": { "operationId": "run-sync-sian.agency-nike-product-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": { "queries": { "title": "๐Ÿ” Search Keywords", "type": "array", "description": "๐Ÿ” **KEYWORD SEARCH:** Free-text Nike searches โ€” exactly what you'd type into nike.com's search bar.\n\n๐Ÿ“ **EXAMPLES:** `air max` ยท `air force 1` ยท `running shoes` ยท `tech fleece` ยท `dunk low`\n\n๐Ÿ’ก **TIP:** Add one keyword per line โ€” each runs as its own search and all results land in the same dataset.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Click \"Bulk edit\" to paste many keywords at once (one per line).\n\nโœ… **IMPORTANT:** Provide either keywords OR Nike product-wall URLs (at least one is needed to have something to scrape).", "default": [ "air max" ], "items": { "type": "string" } }, "scrapeMode": { "title": "โš™๏ธ Scrape Mode", "enum": [ "overview", "detail" ], "type": "string", "description": "โš™๏ธ **SCRAPE DEPTH:** Choose how much data to pull per product.\n\nโšก **Overview (fast):** Product-wall results only โ€” style-color ID, name, subtitle, USD price, full/was price, discount %, colourway count, image, badge and availability. Fastest and cheapest path.\n\n๐Ÿ”ฌ **Detail (sizes + description + colourways):** Everything in Overview PLUS the long product description, per-size availability (with GTIN barcodes), the full image gallery, every colourway, gender, sport tags and the full taxonomy โ€” scraped from each product page.\n\n๐Ÿ’ก **TIP:** Start with Overview to scope a wall, then switch to Detail when you need sizes and full descriptions.", "default": "overview" }, "sort": { "title": "๐Ÿ”ƒ Sort Order", "enum": [ "featured", "newest", "price_low", "price_high" ], "type": "string", "description": "๐Ÿ”ƒ **RESULT ORDERING:** Order wall results using Nike's own native sort options โ€” the same ranking real shoppers see.\n\nโญ **Featured** is Nike's default relevance order ยท ๐Ÿ†• **Newest** leads with the latest drops ยท ๐Ÿ’ฒ **Price** sorts ascending or descending.", "default": "featured" }, "gender": { "title": "๐Ÿšป Gender", "type": "string", "description": "๐Ÿšป **GENDER FILTER:** Restrict to Nike's own gender facet (e.g. `Men`, `Women`, `Unisex`, `Boys`, `Girls`). Resolved against the live wall facets, so it mirrors the site's filter.\n\n๐Ÿ’ก **TIP:** Leave blank to include all." }, "sport": { "title": "๐Ÿ€ Sport / Activity", "type": "string", "description": "๐Ÿ€ **SPORT / ACTIVITY FILTER:** Nike's activity facet (e.g. `Running`, `Basketball`, `Lifestyle`, `Training & Gym`, `Football`). Leave blank for all." }, "color": { "title": "๐ŸŽจ Colour", "type": "string", "description": "๐ŸŽจ **COLOUR FILTER:** Nike's colour facet (e.g. `Black`, `White`, `Blue`, `Red`, `Grey`). Leave blank for all." }, "size": { "title": "๐Ÿ“ Size", "type": "string", "description": "๐Ÿ“ **SIZE FILTER:** A Nike size label as shown on the wall (e.g. `10`, `M 10 / W 11.5`, `M`, `L`). Leave blank for all sizes." }, "price": { "title": "๐Ÿ’ฒ Price Band", "type": "string", "description": "๐Ÿ’ฒ **PRICE BAND FILTER:** A Nike \"Shop by Price\" band label (e.g. `$0 - $50`, `$50 - $100`, `$100 - $150`, `Over $150`). Must match Nike's band label exactly. Leave blank for all prices." }, "urls": { "title": "๐Ÿ”— Nike Wall URLs (Advanced)", "type": "array", "description": "๐Ÿ”— **PASTE PRODUCT-WALL URLs:** Paste full nike.com wall or search URLs to scrape them verbatim โ€” any filters and sorting already in the URL are preserved (a fully-filtered nike.com URL is the most complete filter interface).\n\n๐Ÿ“ **EXAMPLES:** `https://www.nike.com/w/mens-shoes-nik1zy7ok` ยท `https://www.nike.com/w?q=dunk`\n\n๐Ÿ”ฌ **DETAIL MODE:** You can also paste individual product-page URLs (`https://www.nike.com/t/...`) โ€” in Detail mode they're scraped directly.\n\n๐Ÿ–Š๏ธ **BULK EDIT:** Add one URL per line to sweep several walls in a single run.", "items": { "type": "string" } }, "maxResults": { "title": "๐Ÿ”ข Max Results", "minimum": 1, "type": "integer", "description": "๐Ÿ”ข **RESULT CAP:** Maximum number of products (style-colors) to return across all keywords and URLs combined.\n\n๐ŸŽ **TIER-BASED LIMITS:**\n- **FREE users:** Up to 25 products per run\n- **PAID users:** Unlimited โ€” scrape whole walls in a single run\n\n๐Ÿ’ก **TIP:** A single wall page yields ~150โ€“200 style-colors, so keep this low while you dial in your search, then raise it once the output looks right.", "default": 200 } } }, "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 } } } } } } } } } } ```