{ "openapi": "3.0.1", "info": { "title": "UNIQLO Scraper – Products, Prices, Stock & Reviews", "description": "Scrape the UNIQLO catalog in 19 markets: one row per product with name, gender, base and promo price, colors, sizes, rating, image and product URL. Optionally add per-size stock availability and customer reviews. Filter by keyword, category, color, size, promo flag or price. No login needed.", "version": "0.1", "x-build-id": "TnQCSsnSJskFDVNVH" }, "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": { "mode": { "title": "Mode", "enum": [ "search", "product", "reviews", "availability" ], "type": "string", "description": "Which job to run. Search browses or queries the catalogue. The three by-ID modes take product codes you already have and fetch only that one thing — no search, and no product rows you did not ask for.", "default": "search" }, "productIds": { "title": "Product IDs or URLs", "type": "array", "description": "Required by the Products, Reviews and Availability modes; ignored by Search. Accepts a UNIQLO product code (E494100-000) or any UNIQLO product URL, including the url this Actor outputs. Duplicates are removed. Up to 1,000 per run.", "items": { "type": "string" } }, "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": [ "relevance", "1", "2", "3", "4", "5", "6" ], "type": "string", "description": "Result ordering. \"relevance\" sends no sort parameter, which is what uniqlo.com itself does and what ranks a text search sensibly. Note sort=1, despite being labelled Recommended, ranks not-yet-released products above best sellers.", "default": "relevance" }, "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. Charged as availability per product. Use Availability mode instead if stock is all you want.", "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. Charged as review per review. Use Reviews mode instead if reviews are all you want.", "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. Also bounds Reviews mode.", "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 }, "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" }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Stop after this many products. Set to 0 for the entire catalog (long runs). Defaults to 100 to keep a no-input run quick. In the by-ID modes it caps how many of the given product IDs are used; in Reviews mode it caps review rows.", "default": 100 }, "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 }, "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 } } } } } } } } } }