{ "openapi": "3.0.1", "info": { "title": "Levi's Product Scraper - Prices, Sizes & Stock", "description": "Scrape Levi's products — price, discount, colourways, images and per-size stock levels — from a keyword search, any category, the full sitemap, or your own URL list. Covers 24 country storefronts in local currency. Clean JSON for price monitoring and assortment tracking. Pay only for results.", "version": "1.0", "x-build-id": "C24gABif4YkUlP2Fi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~levis-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-levis-product-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/axlymxp~levis-product-scraper/runs": { "post": { "operationId": "runs-sync-axlymxp-levis-product-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/axlymxp~levis-product-scraper/run-sync": { "post": { "operationId": "run-sync-axlymxp-levis-product-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", "required": [ "mode", "country" ], "properties": { "mode": { "title": "How to find products", "enum": [ "search", "category", "sitemap", "urls" ], "type": "string", "description": "Search the catalogue, sweep a category, crawl the market sitemap (largest coverage), or scrape a specific list of product URLs.", "default": "search" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Keyword to search for. Used when mode is 'search'. Note: Levi's search index is US-wide; prices and stock are still localized to your chosen market during detail enrichment.", "default": "501 jeans" }, "categoryId": { "title": "Category ID", "type": "string", "description": "Used when mode is 'category'. This is the last segment of a Levi's category URL — for https://www.levi.com/US/en_US/clothing/men/jeans/c/levi_clothing_men_jeans use 'levi_clothing_men_jeans'." }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Used when mode is 'urls'. Full product page URLs, or bare product codes such as 005010193.", "items": { "type": "string" } }, "changedSince": { "title": "Only products changed since (YYYY-MM-DD)", "type": "string", "description": "Used when mode is 'sitemap'. Skips products whose sitemap 'lastmod' is older than this date — ideal for cheap daily price and stock monitoring." }, "country": { "title": "Market / storefront", "enum": [ "US", "CA", "GB", "IE", "DE", "AT", "CH", "FR", "BE", "NL", "ES", "IT", "PT", "PL", "CZ", "SE", "DK", "FI", "NO", "AU", "NZ", "JP", "IN", "MX" ], "type": "string", "description": "Which Levi's country storefront to scrape. Drives currency, local pricing, product names and the catalogue itself.", "default": "US" }, "maxItems": { "title": "Maximum products", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Stop after this many product rows. Each row is one billable result.", "default": 100 }, "fetchDetails": { "title": "Fetch full product details", "type": "boolean", "description": "Fetch each product's detail page to add per-size stock levels, fit/wash/material attributes, full image gallery and breadcrumbs. Turn off for a faster, lighter run that returns listing fields only.", "default": true }, "includeSwatches": { "title": "Include colourway swatches", "type": "boolean", "description": "Add every other colour of the same style (code, colour name, swatch image, URL). Costs one extra request per product family.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price", "latest-arrival", "best-seller" ], "type": "string", "description": "Result ordering for search and category modes.", "default": "relevance" }, "sortOrder": { "title": "Sort direction", "enum": [ "ascending", "descending" ], "type": "string", "description": "Direction applied to 'Sort by'.", "default": "descending" }, "minRequestInterval": { "title": "Delay between requests (seconds)", "minimum": 0, "maximum": 30, "type": "number", "description": "Politeness delay. Increase to 2-3 seconds if you see rate-limit warnings on very large runs.", "default": 1 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Leave disabled unless you have your own proxies. Levi's Akamai currently rejects Apify's shared datacenter and residential pools outright, so enabling them lowers the success rate. When a proxy is configured the scraper rotates sessions automatically after a block.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }