# Category products list List Uniqlo France products for a taxonomy path such as "37608,84986" with prices, promotions, ratings, stock, colors, and sizes. Offset-paginated. - Platform: [Uniqlo](https://docs.upscrape.com/docs/platforms/uniqlo) - Capability ID: `uniqlo.category.products.list` - Cost: 1 credit per request - Maximum runtime: 30 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "input": { "path": "37608,84986" }, "capability": "uniqlo.category.products.list" }' ``` ## Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `include_unavailable` | `boolean` | No | Keep out-of-stock products in the parsed items. The anonymous API has no server-side in-stock-only filter, so false filters client-side; pagination still reflects upstream totals. Default: `false`. | | `limit` | `integer` | No | Page size. Defaults to 36, clamped to 96. From 1 to 96. Default: `36`. | | `offset` | `integer` | No | Zero-based item offset. At least 0. Default: `0`. | | `path` | `string` | Yes | Taxonomy path from uniqlo.categories.list: "{gender_id},{class_id}" (e.g. "37608,84986" for WOMEN tops). A third category id segment is also accepted. | | `sort` | `integer` | No | Upstream sort order id, 0-6 (0 is the app's default ranking). Values above 6 are rejected by the source. From 0 to 6. Default: `0`. | ### Example input ```json { "path": "37608,84986" } ``` ## Response Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source. ### Illustrative sample output This example shows one response. Values and optional fields vary with the data available. ```json { "items": [ { "colors": [ { "available": null, "code": "COL69", "display_code": "69", "display_visible": true, "name": "BLEU MARINE" }, { "available": null, "code": "COL01", "display_code": "01", "display_visible": true, "name": "BLANC CASSÉ" }, { "available": null, "code": "COL42", "display_code": "42", "display_visible": true, "name": "JAUNE" } ], "currency": "EUR", "image_url": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_69_487001_3x4.jpg", "in_stock": true, "model_id": "487001", "name": "Cardigan à encolure arrondie (Manches courtes)", "price_base": 29.9, "price_promo": null, "product_id": "E487001-000", "rating_average": 4.8, "rating_count": 30, "sizes": [ { "available": null, "code": "SMA001", "display_code": "001", "display_visible": true, "name": "XXS" }, { "available": null, "code": "SMA002", "display_code": "002", "display_visible": true, "name": "XS" }, { "available": null, "code": "SMA003", "display_code": "003", "display_visible": true, "name": "S" } ], "url": "https://www.uniqlo.com/fr/fr/products/E487001-000/00" }, { "colors": [ { "available": null, "code": "COL18", "display_code": "18", "display_visible": true, "name": "BORDEAUX" }, { "available": null, "code": "COL00", "display_code": "00", "display_visible": true, "name": "BLANC" }, { "available": null, "code": "COL03", "display_code": "03", "display_visible": true, "name": "GRIS" } ], "currency": "EUR", "image_url": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_18_465760_3x4.jpg", "in_stock": true, "model_id": "465760", "name": "Mini T-shirt", "price_base": 14.9, "price_promo": null, "product_id": "E465760-000", "rating_average": 4.8, "rating_count": 1038, "sizes": [ { "available": null, "code": "SMA001", "display_code": "001", "display_visible": true, "name": "XXS" }, { "available": null, "code": "SMA002", "display_code": "002", "display_visible": true, "name": "XS" }, { "available": null, "code": "SMA003", "display_code": "003", "display_visible": true, "name": "S" } ], "url": "https://www.uniqlo.com/fr/fr/products/E465760-000/00" }, { "colors": [ { "available": null, "code": "COL65", "display_code": "65", "display_visible": true, "name": "BLEU" }, { "available": null, "code": "COL00", "display_code": "00", "display_visible": true, "name": "BLANC" }, { "available": null, "code": "COL03", "display_code": "03", "display_visible": true, "name": "GRIS" } ], "currency": "EUR", "image_url": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/item/eugoods_65_483596_3x4.jpg", "in_stock": true, "model_id": "483464", "name": "T-shirt boxy", "price_base": 14.9, "price_promo": null, "product_id": "E483596-000", "rating_average": 4.8, "rating_count": 439, "sizes": [ { "available": null, "code": "SMA001", "display_code": "001", "display_visible": true, "name": "XXS" }, { "available": null, "code": "SMA002", "display_code": "002", "display_visible": true, "name": "XS" }, { "available": null, "code": "SMA003", "display_code": "003", "display_visible": true, "name": "S" } ], "url": "https://www.uniqlo.com/fr/fr/products/E483596-000/00" } ], "pagination": { "limit": 36, "offset": 0, "total": 225 }, "raw": { "result": { "aggregations": { "colors": [ { "code": "COL00", "display": { "chipType": 1, "showFlag": true }, "displayCode": "00", "filterCode": "WHITE", "hexBackgroundColor": "#ffffff", "name": "BLANC" }, { "code": "COL01", "display": { "chipType": 1, "showFlag": true }, "displayCode": "01", "filterCode": "WHITE", "hexBackgroundColor": "#ffffff", "name": "BLANC CASSÉ" }, { "code": "COL02", "display": { "chipType": 1, "showFlag": true }, "displayCode": "02", "filterCode": "GRAY", "hexBackgroundColor": "#dedede", "name": "GRIS CLAIR" } ], "flags": [ { "code": "discount", "docCount": 50, "id": 12, "name": "Prix en baisse", "rank": 7 }, { "code": "salesStart", "docCount": 14, "id": 6, "name": "Nouveau", "rank": 12 }, { "code": "newSKU", "docCount": 8, "id": 7, "name": "Nouvelle couleur", "rank": 13 } ], "plds": [ { "code": "PTB000", "displayCode": "000", "docCount": 216, "name": "-" }, { "code": "SLA010", "displayCode": "010", "docCount": 4, "name": "Short" }, { "code": "SLA020", "displayCode": "020", "docCount": 6, "name": "Regular" } ], "prices": [ { "count": 224, "from": 0, "key": "*-50.0", "to": 50 }, { "count": 1, "from": 50, "key": "50.0-70.0", "to": 70 }, { "count": 0, "from": 70, "key": "70.0-100.0", "to": 100 } ], "ratings": [ { "accumulated": 180, "count": 1, "rating": 3 }, { "accumulated": 179, "count": 4, "rating": 3.5 }, { "accumulated": 175, "count": 15, "rating": 4 } ], "sizes": [ { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" }, { "code": "SMA002", "display": { "chipType": 0, "showFlag": true }, "displayCode": "002", "name": "XS" }, { "code": "SMA003", "display": { "chipType": 0, "showFlag": true }, "displayCode": "003", "name": "S" } ], "tree": { "categories": [ { "id": 85018, "name": "T-shirts" }, { "id": 85023, "name": "Tops à brassière intégrée" }, { "id": 146730, "name": "Sans Manches" } ], "classes": [ { "id": 84986, "name": "T-shirts, Sweats & Polaires" }, { "id": 84987, "name": "Jeans, Pantalons & Shorts" }, { "id": 100139, "name": "Chemises, Blouses & Polos" } ], "genders": [ { "id": 37608, "name": "WOMEN" }, { "id": 37609, "name": "MEN" }, { "id": 37610, "name": "KIDS" } ], "subcategories": [ { "id": 85206, "name": "Manches 1/2" }, { "id": 85210, "name": "Manches 3/4" }, { "id": 85207, "name": "Sans Manches" } ] } }, "items": [ { "colors": [ { "code": "COL69", "display": { "chipType": 1, "showFlag": true }, "displayCode": "69", "filterCode": "BLUE", "name": "BLEU MARINE" }, { "code": "COL01", "display": { "chipType": 1, "showFlag": true }, "displayCode": "01", "filterCode": "WHITE", "name": "BLANC CASSÉ" }, { "code": "COL42", "display": { "chipType": 1, "showFlag": true }, "displayCode": "42", "filterCode": "YELLOW", "name": "JAUNE" } ], "genderCategory": "WOMEN", "genderName": "Femme", "images": { "chip": { "01": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_01_487001_chip.jpg", "42": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_42_487001_chip.jpg", "58": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_58_487001_chip.jpg", "60": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_60_487001_chip.jpg", "69": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/chip/goods_69_487001_chip.jpg" }, "main": { "01": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_01_487001_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "42": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_42_487001_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "58": { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/item/goods_58_487001_3x4.jpg", "model": [] }, "60": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_60_487001_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "69": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_69_487001_3x4.jpg", "model": [ { "modelGender": "Women" } ] } }, "sub": [ { "colorCode": "69", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/sub/eugoods_487001_sub3_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, { "colorCode": "69", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/sub/eugoods_487001_sub4_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/sub/goods_487001_sub14_3x4.jpg", "model": [] } ] }, "l1Id": "487001", "name": "Cardigan à encolure arrondie (Manches courtes)", "plds": [ { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" } ], "priceGroup": "00", "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 29.9 }, "isDualPrice": false, "promo": null }, "productId": "E487001-000", "promotionText": "", "rating": { "average": 4.8, "count": 30 }, "representative": { "color": { "code": "COL69", "display": { "chipType": 1, "showFlag": true }, "displayCode": "69", "filterCode": "BLUE", "name": "BLEU MARINE" }, "communicationCode": "487001-69-001-000", "flags": { "priceFlags": [], "productFlags": [] }, "l2Id": "09431828", "pld": { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" }, "sales": true, "size": { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" } }, "representativeColorDisplayCode": "69", "sizeGender": "WOMEN", "sizes": [ { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" }, { "code": "SMA002", "display": { "chipType": 0, "showFlag": true }, "displayCode": "002", "name": "XS" }, { "code": "SMA003", "display": { "chipType": 0, "showFlag": true }, "displayCode": "003", "name": "S" } ], "storeStockOnly": false }, { "colors": [ { "code": "COL18", "display": { "chipType": 1, "showFlag": true }, "displayCode": "18", "filterCode": "RED", "name": "BORDEAUX" }, { "code": "COL00", "display": { "chipType": 1, "showFlag": true }, "displayCode": "00", "filterCode": "WHITE", "name": "BLANC" }, { "code": "COL03", "display": { "chipType": 1, "showFlag": true }, "displayCode": "03", "filterCode": "GRAY", "name": "GRIS" } ], "genderCategory": "WOMEN", "genderName": "Femme", "images": { "chip": { "00": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_00_465760_chip.jpg", "03": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_03_465760_chip.jpg", "09": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_09_465760_chip.jpg", "10": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_10_465760_chip.jpg", "11": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_11_465760_chip.jpg", "12": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_12_465760_chip.jpg", "14": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_14_465760_chip.jpg", "18": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_18_465760_chip.jpg", "28": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_28_465760_chip.jpg", "30": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_30_465760_chip.jpg", "31": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_31_465760_chip.jpg", "34": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_34_465760_chip.jpg", "37": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_37_465760_chip.jpg", "41": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_41_465760_chip.jpg", "52": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_52_465760_chip.jpg", "56": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_56_465760_chip.jpg", "58": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_58_465760_chip.jpg", "59": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_59_465760_chip.jpg", "61": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_61_465760_chip.jpg", "64": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_64_465760_chip.jpg", "66": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_66_465760_chip.jpg", "69": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_69_465760_chip.jpg", "76": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/465760/chip/goods_76_465760_chip.jpg" }, "main": { "00": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_00_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "03": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_03_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "09": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_09_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "18": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_18_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "34": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_34_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "37": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_37_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "41": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_41_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "66": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_66_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "69": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/item/eugoods_69_465760_3x4.jpg", "model": [ { "modelGender": "Women" } ] } }, "sub": [ { "colorCode": "37", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/sub/eugoods_465760_sub3_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, { "colorCode": "03", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/sub/eugoods_465760_sub4_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, { "model": [], "video": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/465760/subvideo/eugoods_465760_sub12_video_3x4.mp4" } ] }, "l1Id": "465760", "name": "Mini T-shirt", "plds": [ { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" } ], "priceGroup": "00", "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 14.9 }, "isDualPrice": false, "promo": null }, "productId": "E465760-000", "promotionText": "", "rating": { "average": 4.8, "count": 1038 }, "representative": { "color": { "code": "COL18", "display": { "chipType": 1, "showFlag": true }, "displayCode": "18", "filterCode": "RED", "name": "BORDEAUX" }, "communicationCode": "465760-18-001-000", "flags": { "priceFlags": [], "productFlags": [] }, "l2Id": "09655036", "pld": { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" }, "sales": true, "size": { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" } }, "representativeColorDisplayCode": "18", "sizeGender": "WOMEN", "sizes": [ { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" }, { "code": "SMA002", "display": { "chipType": 0, "showFlag": true }, "displayCode": "002", "name": "XS" }, { "code": "SMA003", "display": { "chipType": 0, "showFlag": true }, "displayCode": "003", "name": "S" } ], "storeStockOnly": false }, { "colors": [ { "code": "COL65", "display": { "chipType": 1, "showFlag": true }, "displayCode": "65", "filterCode": "BLUE", "name": "BLEU" }, { "code": "COL00", "display": { "chipType": 1, "showFlag": true }, "displayCode": "00", "filterCode": "WHITE", "name": "BLANC" }, { "code": "COL03", "display": { "chipType": 1, "showFlag": true }, "displayCode": "03", "filterCode": "GRAY", "name": "GRIS" } ], "genderCategory": "WOMEN", "genderName": "Femme", "images": { "chip": { "00": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_00_483596_chip.jpg", "03": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_03_483596_chip.jpg", "09": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_09_483596_chip.jpg", "11": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_11_483596_chip.jpg", "30": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_30_483596_chip.jpg", "38": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_38_483596_chip.jpg", "59": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_59_483596_chip.jpg", "65": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/chip/goods_65_483596_chip.jpg" }, "main": { "00": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/item/eugoods_00_483596_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "03": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/item/eugoods_03_483596_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "09": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/item/eugoods_09_483596_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "59": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/item/eugoods_59_483596_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, "65": { "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/item/eugoods_65_483596_3x4.jpg", "model": [ { "modelGender": "Women" } ] } }, "sub": [ { "colorCode": "00", "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/483596/sub/eugoods_483596_sub3_3x4.jpg", "model": [ { "modelGender": "Women" } ] }, { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/483596/sub/goods_483596_sub14_3x4.jpg", "model": [] } ] }, "l1Id": "483464", "name": "T-shirt boxy", "plds": [ { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" } ], "priceGroup": "00", "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 14.9 }, "isDualPrice": false, "promo": null }, "productId": "E483596-000", "promotionText": "", "rating": { "average": 4.8, "count": 439 }, "representative": { "color": { "code": "COL65", "display": { "chipType": 1, "showFlag": true }, "displayCode": "65", "filterCode": "BLUE", "name": "BLEU" }, "communicationCode": "483464-65-001-000", "flags": { "priceFlags": [], "productFlags": [] }, "l2Id": "09116533", "pld": { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" }, "sales": true, "size": { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" } }, "representativeColorDisplayCode": "65", "sizeGender": "WOMEN", "sizes": [ { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" }, { "code": "SMA002", "display": { "chipType": 0, "showFlag": true }, "displayCode": "002", "name": "XS" }, { "code": "SMA003", "display": { "chipType": 0, "showFlag": true }, "displayCode": "003", "name": "S" } ], "storeStockOnly": false } ], "pagination": { "count": 36, "offset": 0, "total": 225 }, "relaxedQueries": [], "relaxedQueryItems": [] }, "status": "ok" } } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `items` | `array` | 3 items | | `items` | `array` | 3 items | | `pagination` | `object` | 3 fields | | `pagination.limit` | `integer` | 36 | | `pagination.offset` | `integer` | 0 | | `pagination.total` | `integer` | 225 | | `raw` | `object` | 2 fields | | `raw.result` | `object` | 5 fields | | `raw.status` | `string` | ok | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. ## Related documentation - [Authentication](https://docs.upscrape.com/docs/api/authentication) - [Jobs and results](https://docs.upscrape.com/docs/api/jobs) - [Errors and retries](https://docs.upscrape.com/docs/api/errors) - [Idempotency](https://docs.upscrape.com/docs/api/idempotency)