# UNIQLO API Scraper (`rl1987/uniqlo-api-scraper`) Actor Scrape the full UNIQLO product catalog via their public commerce API. Filter by keyword, category, color, size, promo flag and price range across any region/language. - **URL**: https://apify.com/rl1987/uniqlo-api-scraper.md - **Developed by:** [R.L.](https://apify.com/rl1987) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 product details This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## UNIQLO Scraper — Products, Prices, Stock & Reviews Extract the **full UNIQLO product catalog** in minutes — names, prices, promotions, colors, sizes, images, ratings, **live stock availability**, and **customer reviews** — exported as structured JSON, CSV, or Excel. Whether you track competitor pricing, monitor inventory, build a fashion dataset, or power a price-comparison app, this UNIQLO scraper turns UNIQLO's online store into clean, ready-to-use data. No login, no browser automation, no flaky page-scraping — just fast, reliable product data from any UNIQLO market. ### Why use this UNIQLO scraper? - 🛍️ **Complete catalog** — pull every product in a market (≈1,200+ for US) or filter down to exactly what you need. - 💲 **Pricing & promotions** — base price, promo price, currency, and merchandising flags (sale, limited-time, new, multibuy). - 📦 **Real-time stock availability** — per-size, per-color in-stock status and quantities, so you know what's actually buyable. - ⭐ **Customer reviews** — ratings, written reviews, fit feedback, and reviewer details for sentiment and product research. - 🌍 **Any region & language** — US, UK, Japan, Germany and more, each in its local language and currency. - 🔎 **Powerful filtering** — search by keyword, category, color, size, price range, and promo flag. - ⚡ **Fast & robust** — concurrent enrichment and proxy support for large, dependable runs. ### Use cases - **Competitor & price monitoring** — track UNIQLO prices and discounts over time. - **Inventory & availability tracking** — detect stockouts and restocks by size and color. - **Market & assortment research** — analyze catalog breadth, categories, and pricing tiers across regions. - **Product reviews & sentiment analysis** — mine ratings and fit feedback for insights. - **Dropshipping & retail apps** — feed product catalogs into price-comparison or shopping tools. - **Data science & ML** — build fashion/apparel datasets for modeling. ### What data you get Per product: product ID, name, gender, currency, base & promo price, average rating and rating count, color list, size list, main image, and a direct product URL. Optionally, per-SKU **stock availability** and **customer reviews** (see below). ### Input Configure the run from the Apify Console UI or via JSON. | Field | Type | Description | |---|---|---| | `region` | string | Market code, default `us` (e.g. `uk`, `jp`, `de`). | | `lang` | string | Language code, default `en`. | | `query` | string | Full-text keyword search. | | `categoryId` | string | Category id (leaf categories only). | | `colorCodes` | array | Filter by color; multiple values combine as OR. | | `sizeCodes` | array | Filter by size; multiple values combine as OR. | | `flagCodes` | array | Promo flags like `discount`, `limitedOffer`, `salesStart`. | | `priceRanges` | array | Price buckets like `10.0-20.0`, `80.0-*`; multiple = OR. | | `sort` | enum | `1` recommended, `2` price ↑, `3` price ↓, `4`–`6` other. | | `fetchVariants` | boolean | Include per-SKU stock availability (in stock, quantity, status). On by default; turn off for a faster catalog-only run. | | `fetchReviews` | boolean | Include customer reviews per product. Off by default. | | `maxReviewsPerProduct` | integer | Cap reviews per product (default 20, `0` = all). | | `variantConcurrency` | integer | Products enriched in parallel (default 5, max 20). | | `maxItems` | integer | Stop after N products. `0` = entire catalog. | | `proxyConfiguration` | object | Proxy settings (Apify Proxy recommended). | Valid filter values (colors, sizes, flags, price buckets, categories) are self-describing: every result set includes the codes that apply to it, so you can discover and refine filters without guesswork. #### Example input ```json { "region": "us", "lang": "en", "query": "jeans", "sort": "2", "maxItems": 200, "fetchVariants": true, "proxyConfiguration": { "useApifyProxy": true } } ```` ### Output Each product is one dataset record: ```json { "productId": "E492040-000", "l1Id": "492040", "name": "Ultra Stretch Skinny Fit Jeans", "genderName": "WOMEN", "priceGroup": "00", "currency": "USD", "basePrice": 39.9, "promoPrice": 29.9, "ratingAverage": 4.5, "ratingCount": 128, "colorCount": 3, "colors": ["GRAY", "BLACK", "NATURAL"], "sizes": ["S", "M", "L"], "mainImage": "https://image.uniqlo.com/...", "url": "https://www.uniqlo.com/us/en/products/E492040-000/00", "region": "us", "lang": "en", "scrapedAt": "2026-06-19T..." } ``` #### Stock availability (`fetchVariants: true`) Adds `variantCount`, `inStockVariantCount`, `anyInStock`, and a `variants` array of per-size, per-color availability: ```json { "l2Id": "09731308", "colorName": "WHITE", "sizeName": "M", "statusCode": "IN_STOCK", "statusLocalized": "In stock", "quantity": 38, "inStock": true, "backInStock": false } ``` #### Customer reviews (`fetchReviews: true`) Adds `reviewCount` and a `reviews` array: ```json { "reviewId": 16969537, "rate": 5, "fit": 3, "title": "Comfortable and Flattering", "comment": "I love the fit of these shorts...", "name": "Summer", "gender": "Female", "ageRange": "35 to 44 years", "location": "California", "purchasedSize": "26inch", "purchasedColorName": "65 BLUE", "helpfulCount": 0, "createdAt": "2026-06-..." } ``` Export any of this to **JSON, CSV, Excel, or XML**, or pull it via the Apify API. ### Pricing This actor uses pay-per-event pricing — you only pay for the data you receive: | Event | When charged | Price | |---|---|---| | Product detail | per product returned | $0.50 / 1,000 products | | Availability data | per product enriched with stock availability | $0.50 / 1,000 products | | Review | per customer review returned | $0.50 / 1,000 reviews | Events are charged only for successfully delivered data. A catalog-only run (`fetchVariants: false`, `fetchReviews: false`) is billed for product details alone; enabling availability and reviews adds those events. ### FAQ **Is scraping UNIQLO legal?** This actor collects only publicly available product information. As with any web data, review the target site's terms and applicable laws, and use the data responsibly. **Do I need an account or API key for UNIQLO?** No. The actor needs no UNIQLO login or credentials. **Which regions are supported?** Any UNIQLO market — set `region` and `lang` (e.g. `us`/`en`, `uk`/`en`, `jp`/`ja`, `de`/`de`). **How do I get only discounted items?** Set `flagCodes` to `discount` (and/or `limitedOffer`), optionally combined with a keyword or category. **Can I limit cost while testing?** Yes — set `maxItems` to a small number and turn off `fetchVariants`/`fetchReviews` for the cheapest possible run. # Actor input Schema ## `region` (type: `string`): Two-letter region/market code that scopes the catalog and the X-FR-Clientid header (e.g. us, uk, jp, de). EU markets may use the eu-cc form. ## `lang` (type: `string`): Two-letter language code for the catalog (e.g. en, ja, de). ## `query` (type: `string`): Full-text search keyword. Leave empty to browse the whole catalog. ## `categoryId` (type: `string`): Filter to one leaf category — pick from the list. Options reflect the US catalog; for other regions you can also type a raw leaf category id (parent/gender ids return 0 results). ## `colorCodes` (type: `array`): Filter by color — pick from the list (OR-ed together). Options reflect the US catalog; for other regions you can also type a raw code such as COL09. ## `sizeCodes` (type: `array`): Filter by size — pick from the list (OR-ed together). Options reflect the US catalog; for other regions you can also type a raw code such as SMA004. ## `flagCodes` (type: `array`): Filter by merchandising flag — pick from the list (OR-ed together). ## `priceRanges` (type: `array`): Filter by price bucket — pick from the list (OR-ed together). Buckets are in the regions currency; you can also type a custom range such as 25.0-50.0. ## `sort` (type: `string`): Result ordering. ## `fetchVariants` (type: `boolean`): For each product, also pull per-SKU (color+size) variants joined with live stock availability (in stock, quantity, status). Adds two extra requests per product, so it is slower. Turn off for a faster catalog-only run. ## `fetchReviews` (type: `boolean`): For each product, also pull customer reviews (rating, title, comment, fit, reviewer info). Adds requests per product, so it is slower. Off by default. ## `maxReviewsPerProduct` (type: `integer`): Cap the number of reviews fetched per product (only used when 'Fetch reviews' is on). 0 = all reviews. ## `variantConcurrency` (type: `integer`): How many products to enrich in parallel (variant availability and/or reviews). Higher is faster but more likely to be rate-limited. ## `maxItems` (type: `integer`): Stop after this many products. Leave at 0 for the entire catalog. ## `proxyConfiguration` (type: `object`): Proxy settings. Recommended for large or repeated runs to avoid rate limiting. ## Actor input object example ```json { "region": "us", "lang": "en", "sort": "1", "fetchVariants": true, "fetchReviews": false, "maxReviewsPerProduct": 20, "variantConcurrency": 5, "maxItems": 0, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `products` (type: `string`): No description # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("rl1987/uniqlo-api-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 = {} # Run the Actor and wait for it to finish run = client.actor("rl1987/uniqlo-api-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 '{}' | apify call rl1987/uniqlo-api-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=rl1987/uniqlo-api-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "UNIQLO API Scraper", "description": "Scrape the full UNIQLO product catalog via their public commerce API. Filter by keyword, category, color, size, promo flag and price range across any region/language.", "version": "0.1", "x-build-id": "wSci8qjDx0IycjzcP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rl1987~uniqlo-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rl1987-uniqlo-api-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/rl1987~uniqlo-api-scraper/runs": { "post": { "operationId": "runs-sync-rl1987-uniqlo-api-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/rl1987~uniqlo-api-scraper/run-sync": { "post": { "operationId": "run-sync-rl1987-uniqlo-api-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": { "region": { "title": "Region", "type": "string", "description": "Two-letter region/market code that scopes the catalog and the X-FR-Clientid header (e.g. us, uk, jp, de). EU markets may use the eu-cc form.", "default": "us" }, "lang": { "title": "Language", "type": "string", "description": "Two-letter language code for the catalog (e.g. en, ja, de).", "default": "en" }, "query": { "title": "Search keyword (q)", "type": "string", "description": "Full-text search keyword. Leave empty to browse the whole catalog." }, "categoryId": { "title": "Category", "type": "string", "description": "Filter to one leaf category — pick from the list. Options reflect the US catalog; for other regions you can also type a raw leaf category id (parent/gender ids return 0 results)." }, "colorCodes": { "title": "Colors", "uniqueItems": true, "type": "array", "description": "Filter by color — pick from the list (OR-ed together). Options reflect the US catalog; for other regions you can also type a raw code such as COL09.", "items": { "type": "string", "enumSuggestedValues": [ "COL00", "COL01", "COL02", "COL03", "COL04", "COL05", "COL06", "COL07", "COL08", "COL09", "COL10", "COL11", "COL12", "COL13", "COL14", "COL15", "COL16", "COL17", "COL18", "COL19", "COL21", "COL23", "COL24", "COL25", "COL26", "COL27", "COL28", "COL30", "COL31", "COL32", "COL33", "COL34", "COL35", "COL36", "COL37", "COL38", "COL39", "COL40", "COL41", "COL42", "COL43", "COL44", "COL45", "COL46", "COL47", "COL50", "COL51", "COL52", "COL53", "COL54", "COL55", "COL56", "COL57", "COL58", "COL59", "COL60", "COL61", "COL62", "COL63", "COL64", "COL65", "COL66", "COL67", "COL68", "COL69", "COL70", "COL71", "COL72", "COL73", "COL74", "COL75", "COL76", "COL77", "COL78", "COL79", "COL80", "COL81", "COL82", "COL83", "COL84", "COL87", "COL88", "COL90", "COL91", "COL93", "COL95" ], "enumTitles": [ "WHITE (COL00)", "OFF WHITE (COL01)", "LIGHT GRAY (COL02)", "GRAY (COL03)", "GRAY (COL04)", "GRAY (COL05)", "GRAY (COL06)", "GRAY (COL07)", "DARK GRAY (COL08)", "BLACK (COL09)", "PINK (COL10)", "PINK (COL11)", "PINK (COL12)", "RED (COL13)", "RED (COL14)", "RED (COL15)", "RED (COL16)", "RED (COL17)", "WINE (COL18)", "WINE (COL19)", "LIGHT ORANGE (COL21)", "ORANGE (COL23)", "ORANGE (COL24)", "ORANGE (COL25)", "ORANGE (COL26)", "ORANGE (COL27)", "DARK ORANGE (COL28)", "NATURAL (COL30)", "BEIGE (COL31)", "BEIGE (COL32)", "KHAKI (COL33)", "BROWN (COL34)", "BROWN (COL35)", "BROWN (COL36)", "BROWN (COL37)", "DARK BROWN (COL38)", "DARK BROWN (COL39)", "CREAM (COL40)", "YELLOW (COL41)", "YELLOW (COL42)", "YELLOW (COL43)", "YELLOW (COL44)", "YELLOW (COL45)", "YELLOW (COL46)", "YELLOW (COL47)", "LIGHT GREEN (COL50)", "GREEN (COL51)", "GREEN (COL52)", "GREEN (COL53)", "GREEN (COL54)", "GREEN (COL55)", "OLIVE (COL56)", "OLIVE (COL57)", "DARK GREEN (COL58)", "DARK GREEN (COL59)", "LIGHT BLUE (COL60)", "BLUE (COL61)", "BLUE (COL62)", "BLUE (COL63)", "BLUE (COL64)", "BLUE (COL65)", "BLUE (COL66)", "BLUE (COL67)", "BLUE (COL68)", "NAVY (COL69)", "LIGHT PURPLE (COL70)", "PURPLE (COL71)", "PURPLE (COL72)", "PURPLE (COL73)", "PURPLE (COL74)", "PURPLE (COL75)", "PURPLE (COL76)", "PURPLE (COL77)", "PURPLE (COL78)", "DARK PURPLE (COL79)", "80 (COL80)", "81 (COL81)", "82 (COL82)", "83 (COL83)", "84 (COL84)", "87 (COL87)", "88 (COL88)", "90 (COL90)", "91 (COL91)", "93 (COL93)", "95 (COL95)" ] } }, "sizeCodes": { "title": "Sizes", "uniqueItems": true, "type": "array", "description": "Filter by size — pick from the list (OR-ed together). Options reflect the US catalog; for other regions you can also type a raw code such as SMA004.", "items": { "type": "string", "enumSuggestedValues": [ "BNC050", "BNC060", "BNC070", "BNC080", "BNC090", "BNC100", "BNC110", "BSU010", "BSU012", "BSW080", "BSW090", "BSW100", "BSW110", "FBU500", "FBU501", "FBU502", "FBU503", "FBU505", "FBU506", "FBU507", "FBU508", "FBU510", "FBU511", "FBU512", "FBU513", "INS022", "INS023", "INS024", "INS025", "INS026", "INS027", "INS028", "INS029", "INS030", "INS031", "INS032", "INS033", "INS034", "INS035", "INS036", "INS038", "INS040", "KAG100", "KAG110", "KAG120", "KAG130", "KAG140", "KAG150", "KAG160", "KXU016", "KXU020", "MSC027", "SIB004", "SIZ999", "SMA001", "SMA002", "SMA003", "SMA004", "SMA005", "SMA006", "SMA007", "SMA008", "SSU045", "SSU050", "SSU055", "SSU060", "SSU065", "SSU070", "SSU075", "SSU080", "SSU085", "SSU090", "SSU095", "WSU024" ], "enumTitles": [ "Age0-3M(50) (BNC050)", "Age3-6M(60) (BNC060)", "Age6-12M(70) (BNC070)", "Age12-18M(80) (BNC080)", "Age18-24M(90) (BNC090)", "Age3(100) (BNC100)", "Age3-4(110) (BNC110)", "6M-18M (BSU010)", "18M-3Y (BSU012)", "Age12-18M(80) (BSW080)", "Age18-24M(90) (BSW090)", "Age3(100) (BSW100)", "Age4(110) (BSW110)", "30/32 AA A (FBU500)", "30/32 B C (FBU501)", "30/32 D DD (FBU502)", "30/32 DDD G (FBU503)", "34/36 AA A (FBU505)", "34/36 B C (FBU506)", "34/36 D DD (FBU507)", "34/36 DDD G (FBU508)", "38/40 AA A (FBU510)", "38/40 B C (FBU511)", "38/40 D DD (FBU512)", "38/40 DDD G (FBU513)", "22inch (INS022)", "23inch (INS023)", "24inch (INS024)", "25inch (INS025)", "26inch (INS026)", "27inch (INS027)", "28inch (INS028)", "29inch (INS029)", "30inch (INS030)", "31inch (INS031)", "32inch (INS032)", "33inch (INS033)", "34inch (INS034)", "35inch (INS035)", "36inch (INS036)", "38inch (INS038)", "40inch (INS040)", "3Y(100) (KAG100)", "3-4Y(110) (KAG110)", "5-6Y(120) (KAG120)", "7-8Y(130) (KAG130)", "9-10Y(140) (KAG140)", "11-12Y(150) (KAG150)", "13Y(160) (KAG160)", "3Y-8Y (KXU016)", "8Y-12Y (KXU020)", "US8-US11 (MSC027)", "size 4 (SIB004)", "One Size (SIZ999)", "XXS (SMA001)", "XS (SMA002)", "S (SMA003)", "M (SMA004)", "L (SMA005)", "XL (SMA006)", "XXL (SMA007)", "3XL (SMA008)", "4.5 (SSU045)", "5.0 (SSU050)", "5.5 (SSU055)", "6.0 (SSU060)", "6.5 (SSU065)", "7.0 (SSU070)", "7.5 (SSU075)", "8.0 (SSU080)", "8.5 (SSU085)", "9.0 (SSU090)", "9.5 (SSU095)", "US W 7.5-10 (WSU024)" ] } }, "flagCodes": { "title": "Promo flags", "uniqueItems": true, "type": "array", "description": "Filter by merchandising flag — pick from the list (OR-ed together).", "items": { "type": "string", "enumSuggestedValues": [ "multibuy", "appmemberLimited", "limitedOffer", "discount", "salesStart", "newSKU", "comingSoon", "onlineOnly", "extraLargeStoreOnly", "colorSizeLimitedPrice", "unisex" ], "enumTitles": [ "Multibuy (multibuy)", "Online + App-Only Offer (appmemberLimited)", "Limited-Time Offer (limitedOffer)", "Sale (discount)", "New (salesStart)", "New color (newSKU)", "Coming Soon (comingSoon)", "Online only (onlineOnly)", "Made with recycled materials (extraLargeStoreOnly)", "Select Colors/Sizes Only (colorSizeLimitedPrice)", "UNISEX (unisex)" ] } }, "priceRanges": { "title": "Price ranges", "uniqueItems": true, "type": "array", "description": "Filter by price bucket — pick from the list (OR-ed together). Buckets are in the regions currency; you can also type a custom range such as 25.0-50.0.", "items": { "type": "string", "enumSuggestedValues": [ "*-10.0", "10.0-20.0", "20.0-40.0", "40.0-60.0", "60.0-80.0", "80.0-*" ], "enumTitles": [ "Under 10", "10 – 20", "20 – 40", "40 – 60", "60 – 80", "80 and up" ] } }, "sort": { "title": "Sort order", "enum": [ "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Result ordering.", "default": "1" }, "fetchVariants": { "title": "Fetch variant availability", "type": "boolean", "description": "For each product, also pull per-SKU (color+size) variants joined with live stock availability (in stock, quantity, status). Adds two extra requests per product, so it is slower. Turn off for a faster catalog-only run.", "default": true }, "fetchReviews": { "title": "Fetch reviews", "type": "boolean", "description": "For each product, also pull customer reviews (rating, title, comment, fit, reviewer info). Adds requests per product, so it is slower. Off by default.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 0, "type": "integer", "description": "Cap the number of reviews fetched per product (only used when 'Fetch reviews' is on). 0 = all reviews.", "default": 20 }, "variantConcurrency": { "title": "Per-product fetch concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many products to enrich in parallel (variant availability and/or reviews). Higher is faster but more likely to be rate-limited.", "default": 5 }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many products. Leave at 0 for the entire catalog.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Recommended for large or repeated runs to avoid rate limiting.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```