{ "components": { "schemas": { "CredentialsRequiredError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "credentials_required", "type": "string" }, "message": { "const": "this capability requires authentication credentials; save them via POST /credentials", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "CreditLimitError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "credit_limit_exceeded", "type": "string" }, "message": { "const": "published job price exceeds the requested maximum credits", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "ExecuteAcceptedResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "uniqlo.product.get" ], "type": "string" }, "coalesced": { "type": "boolean" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "uniqlo" ], "type": "string" }, "poll_after_ms": { "description": "Wait at least this long before polling.", "minimum": 0, "type": "integer" }, "poll_url": { "description": "GET this URL with the same API key to read the job.", "format": "uri", "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "state": { "const": "queued", "type": "string" } }, "required": [ "job_id", "request_id", "platform", "capability", "state" ], "type": "object" }, "ExecuteNetwork": { "additionalProperties": false, "properties": { "session_id": { "description": "Optional explicit session identifier.", "minLength": 1, "type": "string" }, "session_key": { "description": "Optional stable key used to derive a reusable session.", "minLength": 1, "type": "string" }, "sticky": { "description": "Whether the request should reuse the resolved session.", "type": "boolean" } }, "type": "object" }, "ExecuteReplayResponse": { "additionalProperties": false, "description": "Replayed response matching the original job's current state (completed, failed, or pending).", "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "uniqlo.product.get" ], "type": "string" }, "completed_at": { "anyOf": [ { "description": "When the source data was read and the job completed (ISO 8601 UTC). This is the observation time for the returned data, to the job's precision, not a per-item upstream timestamp. Null unless the job completed.", "format": "date-time", "type": "string" }, { "type": "null" } ] }, "error": {}, "idempotent_replay": { "const": true, "type": "boolean" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "uniqlo" ], "type": "string" }, "poll_after_ms": { "minimum": 0, "type": "integer" }, "poll_url": { "format": "uri", "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": {}, "started_at": { "anyOf": [ { "description": "When the job began executing (ISO 8601 UTC), or null if it never ran.", "format": "date-time", "type": "string" }, { "type": "null" } ] }, "state": { "enum": [ "queued", "running", "retrying", "completed", "failed" ], "type": "string" }, "stats": {}, "success": { "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "idempotent_replay" ], "type": "object" }, "IdempotencyConflictError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "idempotency_conflict", "type": "string" }, "message": { "const": "idempotency key has already been used for a different request", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "InternalError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "internal_error", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "JobBilling": { "additionalProperties": false, "properties": { "credits_charged": { "anyOf": [ { "description": "Actual credits charged, which may be a part of a credit such as 0.25. Null only when retained historical facts cannot establish the amount.", "minimum": 0, "type": "number" }, { "type": "null" } ] }, "credits_per_unit": { "anyOf": [ { "description": "Snapshotted price for one billed unit, which may be a part of a credit such as 0.25. Zero only for historical free work; null when unknown.", "minimum": 0, "type": "number" }, { "type": "null" } ] }, "model": { "enum": [ "per_request", "per_record", "free", "unknown" ], "type": "string" }, "pricing": { "additionalProperties": false, "properties": { "rule_id": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ] }, "scope": { "anyOf": [ { "enum": [ "module", "platform", "capability" ], "type": "string" }, { "type": "null" } ] }, "source": { "enum": [ "manifest", "price_book" ], "type": "string" }, "version": { "anyOf": [ { "minimum": 1, "type": "integer" }, { "type": "null" } ] } }, "required": [ "source", "scope", "version", "rule_id" ], "type": "object" }, "settlement": { "description": "Why this job did or did not produce a credit debit. A zero charge is not implicitly described as free.", "enum": [ "prepaid_credits", "included_subscription", "out_of_band_contract", "free", "not_billable", "zero_charge_requires_review", "unknown" ], "type": "string" }, "units": { "anyOf": [ { "description": "Billed units under the stated model. Null when units do not apply or cannot be established.", "minimum": 0, "type": "integer" }, { "type": "null" } ] } }, "required": [ "model", "units", "credits_per_unit", "credits_charged", "settlement", "pricing" ], "type": "object" }, "JobErrorObject": { "additionalProperties": false, "properties": { "code": { "description": "Machine-readable error code (e.g. forbidden, not_found, invalid_input, upstream_timeout, upstream_error).", "type": "string" }, "message": { "description": "Human-readable error description.", "type": "string" }, "reason": { "description": "A stable machine-readable reason when the code alone is not specific enough, for example country_unverified on a forbidden response where the requested country could not be verified. Present only for reviewed reasons; never a raw upstream diagnostic.", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "JobFailedResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "uniqlo.product.get" ], "type": "string" }, "completed_at": { "anyOf": [ { "description": "When the source data was read and the job completed (ISO 8601 UTC). This is the observation time for the returned data, to the job's precision, not a per-item upstream timestamp. Null unless the job completed.", "format": "date-time", "type": "string" }, { "type": "null" } ] }, "error": { "$ref": "#/components/schemas/JobErrorObject" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "uniqlo" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "type": "null" }, "started_at": { "anyOf": [ { "description": "When the job began executing (ISO 8601 UTC), or null if it never ran.", "format": "date-time", "type": "string" }, { "type": "null" } ] }, "state": { "const": "failed", "type": "string" }, "stats": { "type": "null" }, "success": { "const": false, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "error", "results", "stats", "started_at", "completed_at" ], "type": "object" }, "JobPendingResponse": { "additionalProperties": false, "properties": { "capability": { "enum": [ "uniqlo.product.get" ], "type": "string" }, "job_id": { "format": "uuid", "type": "string" }, "platform": { "enum": [ "uniqlo" ], "type": "string" }, "poll_after_ms": { "description": "Wait at least this long before polling.", "minimum": 0, "type": "integer" }, "poll_url": { "description": "GET this URL with the same API key to read the job.", "format": "uri", "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "state": { "enum": [ "queued", "running", "retrying" ], "type": "string" } }, "required": [ "job_id", "request_id", "platform", "capability", "state" ], "type": "object" }, "JobStats": { "additionalProperties": false, "properties": { "attempts": { "description": "Number of execution attempts made for the job.", "minimum": 0, "type": "integer" }, "duration_ms": { "anyOf": [ { "description": "Duration of the final execution attempt.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "failed": { "const": 0, "type": "integer" }, "passed": { "const": 1, "type": "integer" }, "processing_duration_ms": { "anyOf": [ { "description": "Total job processing time, including retries and retry backoff.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "queue_duration_ms": { "anyOf": [ { "description": "Time between job acceptance and the first execution attempt.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "run_duration_ms": { "anyOf": [ { "description": "Canonical run time from job acceptance to completion. Use this for customer-facing timing.", "minimum": 0, "type": "integer" }, { "type": "null" } ] }, "total": { "const": 1, "type": "integer" } }, "required": [ "total", "passed", "failed", "run_duration_ms", "duration_ms", "processing_duration_ms", "queue_duration_ms", "attempts" ], "type": "object" }, "NotFoundError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "not_found", "type": "string" }, "message": { "enum": [ "job not found", "monitor not found", "monitors are not available for this account" ], "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "QuotaError": { "oneOf": [ { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "account_inactive", "type": "string" }, "message": { "const": "an active paid account is required", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "quota_exhausted", "type": "string" }, "message": { "const": "request quota exhausted for current billing period", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "quota_exhausted", "type": "string" }, "message": { "const": "not enough credits for this request; buy credits at https://app.upscrape.com/app/billing to continue", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "account_inactive", "type": "string" }, "message": { "const": "this account is not active; buy credits at https://app.upscrape.com/app/billing to activate it, or contact support if it was suspended", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" } ] }, "RateLimitError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "rate_limited", "type": "string" }, "message": { "const": "rate limit exceeded", "type": "string" }, "retry_after_ms": { "description": "Milliseconds until the rolling window resets enough to retry. The `retry-after` response header carries the same value rounded up to seconds.", "minimum": 0, "type": "integer" } }, "required": [ "code", "message", "retry_after_ms" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "UnauthorizedError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "unauthorized", "type": "string" }, "message": { "enum": [ "authentication required", "invalid or revoked API key; check it under API keys in the console, sent as Authorization: Bearer ", "missing API key; send it as the header Authorization: Bearer " ], "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "UnavailableError": { "additionalProperties": false, "properties": { "error": { "additionalProperties": false, "properties": { "code": { "const": "temporarily_unavailable", "type": "string" }, "message": { "const": "this capability is temporarily unavailable; try again later or use another capability", "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "error", "request_id" ], "type": "object" }, "UniqloProductGetCompletedJob": { "additionalProperties": false, "properties": { "billing": { "$ref": "#/components/schemas/JobBilling" }, "capability": { "enum": [ "uniqlo.product.get" ], "type": "string" }, "completed_at": { "anyOf": [ { "description": "When the source data was read and the job completed (ISO 8601 UTC). This is the observation time for the returned data, to the job's precision, not a per-item upstream timestamp. Null unless the job completed.", "format": "date-time", "type": "string" }, { "type": "null" } ] }, "job_id": { "format": "uuid", "type": "string" }, "outcome": { "description": "Truthful module completion detail; status is complete unless the module reports partial or incomplete output.", "type": "object" }, "platform": { "enum": [ "uniqlo" ], "type": "string" }, "request_id": { "format": "uuid", "type": "string" }, "results": { "items": { "additionalProperties": false, "properties": { "data": { "description": "Raw capability output. Its shape may evolve with the upstream source; the example is illustrative, not a compatibility guarantee.", "example": { "product_id": "E487001-000", "raw": { "result": { "productId": "E487001-000", "washingInformation": "Lavage en machine sur cycle délicat à une température maximale de 40 °C, Lavage à sec, Ne convient pas au séchage en machine.", "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" } ], "rating": { "average": 4.8, "count": 130, "fit": 2.95, "rateCount": { "five": 113, "four": 13, "one": 0, "three": 4, "two": 0 } }, "nextModelProducts": [], "representative": { "color": { "code": "COL69", "display": { "chipType": 1, "showFlag": true }, "displayCode": "69", "filterCode": "BLUE", "name": "BLEU MARINE" }, "flags": { "priceFlags": [ { "code": "discount", "detail": "", "effectiveTime": { "end": 0, "start": 1791849600 }, "id": 12, "name": "Prix en baisse", "type": "price_flag" } ], "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" } }, "l2s": [ { "alterations": {}, "color": { "code": "COL01", "display": { "chipType": 1, "showFlag": true }, "displayCode": "01", "filterCode": "WHITE", "name": "BLANC CASSÉ" }, "communicationCode": "487001-01-001-000", "flags": { "priceFlags": [ { "code": "discount", "detail": "", "effectiveTime": { "end": 0, "start": 1791849600 }, "id": 12, "name": "Prix en baisse", "type": "price_flag" } ], "productFlags": [] }, "l2Id": "09431748", "pld": { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" }, "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 29.9 }, "discountPercentage": null, "isDualPrice": true, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "currency": { "code": "EUR", "symbol": "€" }, "value": 12.9 }, "taxPolicy": "INCLUSIVE" }, "sales": true, "salesType": "NORMAL", "searchInStoresAvailable": true, "size": { "code": "SMA001", "display": { "chipType": 0, "showFlag": true }, "displayCode": "001", "name": "XXS" } }, { "alterations": {}, "color": { "code": "COL01", "display": { "chipType": 1, "showFlag": true }, "displayCode": "01", "filterCode": "WHITE", "name": "BLANC CASSÉ" }, "communicationCode": "487001-01-002-000", "flags": { "priceFlags": [ { "code": "discount", "detail": "", "effectiveTime": { "end": 0, "start": 1791849600 }, "id": 12, "name": "Prix en baisse", "type": "price_flag" } ], "productFlags": [] }, "l2Id": "09431749", "pld": { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" }, "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 29.9 }, "discountPercentage": null, "isDualPrice": true, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "currency": { "code": "EUR", "symbol": "€" }, "value": 12.9 }, "taxPolicy": "INCLUSIVE" }, "sales": true, "salesType": "NORMAL", "searchInStoresAvailable": true, "size": { "code": "SMA002", "display": { "chipType": 0, "showFlag": true }, "displayCode": "002", "name": "XS" } }, { "alterations": {}, "color": { "code": "COL01", "display": { "chipType": 1, "showFlag": true }, "displayCode": "01", "filterCode": "WHITE", "name": "BLANC CASSÉ" }, "communicationCode": "487001-01-003-000", "flags": { "priceFlags": [ { "code": "discount", "detail": "", "effectiveTime": { "end": 0, "start": 1791849600 }, "id": 12, "name": "Prix en baisse", "type": "price_flag" } ], "productFlags": [] }, "l2Id": "09431750", "pld": { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" }, "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 29.9 }, "discountPercentage": null, "isDualPrice": true, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "currency": { "code": "EUR", "symbol": "€" }, "value": 12.9 }, "taxPolicy": "INCLUSIVE" }, "sales": true, "salesType": "NORMAL", "searchInStoresAvailable": true, "size": { "code": "SMA003", "display": { "chipType": 0, "showFlag": true }, "displayCode": "003", "name": "S" } } ], "breadcrumbs": { "category": { "id": "100104", "level": 3, "locale": "Pulls", "name": "jumpers" }, "class": { "id": "100103", "level": 2, "locale": "Pulls & Cardigans", "name": "jumpers" }, "gender": { "id": "37608", "level": 1, "locale": "WOMEN", "name": "women" }, "subcategory": { "id": "100117", "level": 4, "locale": "Manches 3/4", "name": "short half sleeve" } }, "writeReviewAvailable": true, "composition": "60% Coton, 40% Modal", "promoConditionText": "", "productSync": {}, "sizeChartUrl": "https://www.uniqlo.com/fr/fr/size/487001_size.html", "careInstruction": "
", "name": "Cardigan à encolure arrondie (Manches courtes)", "topCategories": [ "women" ], "prices": { "base": { "currency": { "code": "EUR", "symbol": "€" }, "value": 29.9 }, "discountPercentage": null, "isDualPrice": true, "lowestPriceDetails": { "canDisplayLowestPrice": true, "lowestPeriod": 30, "lowestPrice": 19.9 }, "promo": { "currency": { "code": "EUR", "symbol": "€" }, "value": 12.9 }, "taxPolicy": "INCLUSIVE" }, "freeInformation": "", "taxPolicy": "INCLUSIVE", "plds": [ { "code": "PTB000", "display": { "chipType": 0, "showFlag": false }, "displayCode": "000", "name": "-" } ], "genderCategory": "WOMEN", "tags": [], "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": { "gender": [ "Women" ], "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_01_487001_3x4.jpg", "model": [ { "modelExpirationDate": { "nh": "", "sh": "" }, "modelGender": "Women", "modelId": "1149", "modelSize": { "universal": { "height": "174" }, "us": { "height": "68.5" } }, "products": [ { "colorCode": "01", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "30", "itemId": "488852", "sampleCode": "226F215A", "sizeCode": "SMA004" }, { "colorCode": "39", "itemId": "487800", "sampleCode": "266F019B", "sizeCode": "SMA004" } ] } ], "productCombinations": [], "showProductsInImageLink": true }, "42": { "gender": [ "Women" ], "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_42_487001_3x4.jpg", "model": [ { "modelExpirationDate": { "nh": "", "sh": "" }, "modelGender": "Women", "modelId": "1462", "modelSize": { "universal": { "height": "174" }, "us": { "height": "68.5" } }, "products": [ { "colorCode": "42", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "488867", "sampleCode": "226F117B", "sizeCode": "SMA004" } ] } ], "productCombinations": [], "showProductsInImageLink": true }, "58": { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/item/goods_58_487001_3x4.jpg", "model": [], "productCombinations": [], "showProductsInImageLink": false }, "60": { "gender": [ "Women" ], "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_60_487001_3x4.jpg", "model": [ { "modelExpirationDate": { "nh": "", "sh": "" }, "modelGender": "Women", "modelId": "1224", "modelSize": { "universal": { "height": "170" }, "us": { "height": "66.9" } }, "products": [ { "colorCode": "60", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "38", "itemId": "486095", "sampleCode": "276F115A", "sizeCode": "SMA004" } ] } ], "productCombinations": [], "showProductsInImageLink": true }, "69": { "gender": [ "Women" ], "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/item/eugoods_69_487001_3x4.jpg", "model": [ { "modelExpirationDate": { "nh": "", "sh": "" }, "modelGender": "Women", "modelId": "893", "modelSize": { "universal": { "height": "172" }, "us": { "height": "67.7" } }, "products": [ { "colorCode": "69", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "482281", "sampleCode": "226H046A", "sizeCode": "SMA004" }, { "colorCode": "39", "itemId": "479164", "sampleCode": "265F027A", "sizeCode": "SMA004" } ] } ], "productCombinations": [], "showProductsInImageLink": true } }, "sub": [ { "colorCode": "69", "gender": [ "Women" ], "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/sub/eugoods_487001_sub3_3x4.jpg", "model": [ { "modelExpirationDate": { "nh": "", "sh": "" }, "modelGender": "Women", "modelId": "893", "modelSize": { "universal": { "height": "172" }, "us": { "height": "67.7" } }, "products": [ { "colorCode": "69", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "482281", "sampleCode": "226H046A", "sizeCode": "SMA004" }, { "colorCode": "39", "itemId": "479164", "sampleCode": "265F027A", "sizeCode": "SMA004" } ] } ], "showProductsInImageLink": true }, { "colorCode": "69", "gender": [ "Women" ], "image": "https://image.uniqlo.com/UQ/ST3/eu/imagesgoods/487001/sub/eugoods_487001_sub4_3x4.jpg", "model": [ { "modelExpirationDate": { "nh": "", "sh": "" }, "modelGender": "Women", "modelId": "893", "modelSize": { "universal": { "height": "172" }, "us": { "height": "67.7" } }, "products": [ { "colorCode": "69", "itemId": "487001", "sampleCode": "256F062A", "sizeCode": "SMA004" }, { "colorCode": "69", "itemId": "482281", "sampleCode": "226H046A", "sizeCode": "SMA004" }, { "colorCode": "39", "itemId": "479164", "sampleCode": "265F027A", "sizeCode": "SMA004" } ] } ], "showProductsInImageLink": true }, { "image": "https://image.uniqlo.com/UQ/ST3/WesternCommon/imagesgoods/487001/sub/goods_487001_sub14_3x4.jpg", "showProductsInImageLink": false } ] }, "shortDescription": "", "designDetail": "", "colors": [ { "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" }, { "code": "COL58", "display": { "chipType": 1, "showFlag": true }, "displayCode": "58", "filterCode": "GREEN", "name": "VERT FONCÉ" } ], "sizeInformation": "", "l1Ids": [ "487001" ], "longDescription": "- Coupe courte et ajustée.", "genderName": "Femme", "countriesOfOrigin": [ { "code": "CN", "lid": "text_country_cn" }, { "code": "VN", "lid": "text_country_vn" } ], "promotionText": "", "promoId": "", "productTypeKr": "", "productType": "unknown", "priceGroup": "00" }, "status": "ok" }, "skus": [ { "available": true, "color_code": "COL01", "color_name": "BLANC CASSÉ", "currency": "EUR", "price_base": 29.9, "price_promo": 12.9, "size_code": "SMA001", "size_name": "XXS" }, { "available": true, "color_code": "COL01", "color_name": "BLANC CASSÉ", "currency": "EUR", "price_base": 29.9, "price_promo": 12.9, "size_code": "SMA002", "size_name": "XS" }, { "available": true, "color_code": "COL01", "color_name": "BLANC CASSÉ", "currency": "EUR", "price_base": 29.9, "price_promo": 12.9, "size_code": "SMA003", "size_name": "S" } ], "url": "https://www.uniqlo.com/fr/fr/products/E487001-000" } }, "error": { "type": "null" }, "index": { "const": 0, "type": "integer" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "index", "url", "data", "error" ], "type": "object" }, "maxItems": 1, "minItems": 1, "type": "array" }, "started_at": { "anyOf": [ { "description": "When the job began executing (ISO 8601 UTC), or null if it never ran.", "format": "date-time", "type": "string" }, { "type": "null" } ] }, "state": { "const": "completed", "type": "string" }, "stats": { "$ref": "#/components/schemas/JobStats" }, "success": { "const": true, "type": "boolean" } }, "required": [ "job_id", "request_id", "platform", "capability", "state", "success", "started_at", "completed_at", "results", "billing", "stats", "outcome" ], "type": "object" }, "UniqloProductGetExecuteRequest": { "additionalProperties": false, "description": "Fetch one Uniqlo France product's per-colour/size price (EUR, base and promo) and availability from its product id.", "example": { "capability": "uniqlo.product.get", "input": { "product_id": "E487001-000" } }, "properties": { "capability": { "enum": [ "uniqlo.product.get" ], "type": "string" }, "input": { "$ref": "#/components/schemas/UniqloProductGetInput" }, "max_credits": { "description": "Optional credit ceiling. The job is refused with `credit_limit_exceeded` before acceptance when its published price is higher. Takes precedence over the `X-Max-Credits` header.", "minimum": 1, "type": "integer" }, "network": { "$ref": "#/components/schemas/ExecuteNetwork" }, "timeout_ms": { "description": "Optional request timeout in milliseconds. Values above the capability timeout are rejected.", "maximum": 30000, "minimum": 1, "type": "integer" } }, "required": [ "capability", "input" ], "type": "object" }, "UniqloProductGetInput": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "anyOf": [ { "required": [ "product_id" ] }, { "required": [ "url" ] } ], "properties": { "product_id": { "maxLength": 24, "pattern": "^[A-Za-z0-9]{4,20}-[0-9]{3}$", "type": "string" }, "url": { "description": "Canonical HTTPS Uniqlo France product URL returned by a listing or search. Product ID and URL must agree if both are supplied.", "maxLength": 100, "pattern": "^https://www\\.uniqlo\\.com/fr/fr/products/[A-Za-z0-9]{4,20}-[0-9]{3}(?:/[0-9]{2})?$", "type": "string" } }, "title": "uniqlo.product.get", "type": "object" }, "ValidationErrors": { "additionalProperties": false, "properties": { "error": { "description": "The standard error envelope, as on every other failure. Branch on `error.code`.", "properties": { "code": { "const": "invalid_input", "type": "string" }, "fields": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Failed fields and their messages.", "type": "object" }, "message": { "description": "One-line summary of the failed fields.", "type": "string" } }, "required": [ "code", "message", "fields" ], "type": "object" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Retained for compatibility: the same field map as `error.fields`. New integrations should read `error`.", "type": "object" }, "request_id": { "description": "Safe Upscrape HTTP request identifier, also returned in the x-request-id header. For accepted jobs, job_id is the durable execution identifier.", "minLength": 1, "type": "string" } }, "required": [ "errors", "error", "request_id" ], "type": "object" } }, "securitySchemes": { "BearerAuth": { "bearerFormat": "API Key", "scheme": "bearer", "type": "http" } } }, "info": { "description": "Get the Uniqlo France catalog as clean JSON: product prices and markdowns in euros, stock by colour and size, and ratings. Browse a category, search by keyword or read one product.\nThis spec includes only the live `Uniqlo` capabilities exposed by Upscrape.\nExecution uses the generic `POST /execute` endpoint and job polling uses `GET /jobs/{id}`.\nSupported capabilities: `uniqlo.product.get`\n## Rate limiting\n\nRequests are rate-limited per API key at **1200 requests per minute** on a rolling window. Every response includes `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` (Unix ms) headers so clients can self-pace. When the limit is exceeded the API returns `429` with a `rate_limited` error body and a `retry-after` header in seconds plus a `retry_after_ms` field on the body for finer-grained backoff.", "title": "Uniqlo API", "version": "1.0.0" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/execute": { "post": { "description": "All executions are asynchronous. Submit a capability-specific payload to `POST /execute`, then poll the returned `job_id`.", "operationId": "uniqlo_execute", "parameters": [ { "description": "Optional idempotency key. Reusing the same key with the same request replays the original job.", "in": "header", "name": "Idempotency-Key", "required": false, "schema": { "maxLength": 255, "type": "string" } }, { "description": "Optional credit ceiling for this job, as a positive integer. The request is refused with `422 credit_limit_exceeded` before acceptance when the published price for the submitted input is higher. The body field `max_credits` takes precedence when both are sent. It never changes the price.", "in": "header", "name": "X-Max-Credits", "required": false, "schema": { "minimum": 1, "type": "integer" } }, { "description": "Request synchronous completion. Use `wait=N` to hold the connection up to N seconds (max 30). If the job completes within the window, the response is `200` with full results (same shape as `GET /jobs/{id}`). If not, the response is the normal `202` with a `job_id` for polling. Omit this header for default asynchronous behavior.", "examples": { "wait30": { "summary": "Wait up to 30 seconds", "value": "wait=30" }, "wait5": { "summary": "Wait up to 5 seconds", "value": "wait=5" } }, "in": "header", "name": "Prefer", "required": false, "schema": { "example": "wait=30", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "capability": "uniqlo.product.get", "input": { "product_id": "E487001-000" } }, "schema": { "$ref": "#/components/schemas/UniqloProductGetExecuteRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/UniqloProductGetCompletedJob" }, { "$ref": "#/components/schemas/ExecuteReplayResponse" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Job completed within the `Prefer: wait` window, or existing job replayed via idempotency key.", "headers": { "Preference-Applied": { "description": "Present when the server honored the `Prefer: wait` preference.", "schema": { "example": "wait=30", "type": "string" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "uniqlo.product.get", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "uniqlo", "poll_after_ms": 2000, "poll_url": "https://data.upscrape.com/jobs/00000000-0000-0000-0000-000000000001", "request_id": "00000000-0000-0000-0000-000000000001", "state": "queued" }, "schema": { "$ref": "#/components/schemas/ExecuteAcceptedResponse" } } }, "description": "Job accepted and queued, or attached to an identical active keyless request.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "402": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuotaError" } } }, "description": "The authenticated account cannot execute the request." }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobFailedResponse" } } }, "description": "The requested public data is unavailable or access is denied. Confirmed account privacy and sign-in requirements include a safe reason." }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobFailedResponse" } } }, "description": "The upstream source confirms that the requested resource was not found. The response retains the job identity." }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdempotencyConflictError" } } }, "description": "Idempotency conflict" }, "422": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ValidationErrors" }, { "$ref": "#/components/schemas/CredentialsRequiredError" }, { "$ref": "#/components/schemas/CreditLimitError" } ] } } }, "description": "The request body failed validation." }, "424": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobFailedResponse" } } }, "description": "A durable job reached a terminal upstream dependency failure within the Prefer wait window. The body retains job_id and request_id for diagnosis." }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 }, "request_id": "safe-http-request-id" }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InternalError" } } }, "description": "Unexpected server error" }, "503": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnavailableError" } } }, "description": "The capability cannot be served right now. Do not retry immediately; try again later." } }, "security": [ { "BearerAuth": [] } ], "summary": "Queue a Uniqlo capability run", "tags": [ "Execution" ] } }, "/jobs/{id}": { "get": { "description": "Get job status and result", "operationId": "uniqlo_getJob", "parameters": [ { "description": "The job ID returned by `POST /execute`.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/UniqloProductGetCompletedJob" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Completed or terminal job state.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "uniqlo.product.get", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "uniqlo", "poll_after_ms": 2000, "poll_url": "https://data.upscrape.com/jobs/00000000-0000-0000-0000-000000000001", "request_id": "00000000-0000-0000-0000-000000000001", "state": "running" }, "schema": { "$ref": "#/components/schemas/JobPendingResponse" } } }, "description": "Job is still queued, running, or retrying.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotFoundError" } } }, "description": "Job not found" }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 }, "request_id": "safe-http-request-id" }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } } }, "security": [ { "BearerAuth": [] } ], "summary": "Poll a Uniqlo job", "tags": [ "Jobs" ] } }, "/jobs/{id}/result": { "get": { "description": "Backward-compatible alias for `/jobs/{id}`.", "operationId": "uniqlo_getJobResult", "parameters": [ { "description": "The job ID returned by `POST /execute`.", "in": "path", "name": "id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/UniqloProductGetCompletedJob" }, { "$ref": "#/components/schemas/JobFailedResponse" } ] } } }, "description": "Completed or terminal job state.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "202": { "content": { "application/json": { "example": { "capability": "uniqlo.product.get", "job_id": "00000000-0000-0000-0000-000000000001", "platform": "uniqlo", "poll_after_ms": 2000, "poll_url": "https://data.upscrape.com/jobs/00000000-0000-0000-0000-000000000001", "request_id": "00000000-0000-0000-0000-000000000001", "state": "running" }, "schema": { "$ref": "#/components/schemas/JobPendingResponse" } } }, "description": "Job is still queued, running, or retrying.", "headers": { "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnauthorizedError" } } }, "description": "Unauthorized" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotFoundError" } } }, "description": "Job not found" }, "429": { "content": { "application/json": { "example": { "error": { "code": "rate_limited", "message": "rate limit exceeded", "retry_after_ms": 4200 }, "request_id": "safe-http-request-id" }, "schema": { "$ref": "#/components/schemas/RateLimitError" } } }, "description": "The per-API-key rate limit has been exceeded. Clients should back off until `retry_after_ms` has elapsed (or `retry-after` seconds).", "headers": { "retry-after": { "description": "Seconds until the client may retry (ceiling of `retry_after_ms`).", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-limit": { "description": "Per-API-key request ceiling over the rolling window.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-remaining": { "description": "Requests remaining in the current window before throttling.", "schema": { "minimum": 0, "type": "integer" } }, "x-ratelimit-reset": { "description": "Unix epoch milliseconds at which the current window resets.", "schema": { "minimum": 0, "type": "integer" } } } } }, "security": [ { "BearerAuth": [] } ], "summary": "Poll a Uniqlo job", "tags": [ "Jobs" ] } } }, "servers": [ { "url": "https://data.upscrape.com" } ], "tags": [ { "description": "Submit asynchronous capability runs.", "name": "Execution" }, { "description": "Poll queued jobs for status and results.", "name": "Jobs" } ] }