{ "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 } } } } } } } } } }