{ "openapi": "3.0.1", "info": { "title": "Calvin Klein Product Scraper", "description": "Scrape Calvin Klein products from official European and UK shops using search queries or category/search URLs, with optional full product details.", "version": "1.0", "x-build-id": "ZQEJVXEaRdEK9kHQV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rigelbytes~calvinklein-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rigelbytes-calvinklein-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/rigelbytes~calvinklein-scraper/runs": { "post": { "operationId": "runs-sync-rigelbytes-calvinklein-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/rigelbytes~calvinklein-scraper/run-sync": { "post": { "operationId": "run-sync-rigelbytes-calvinklein-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": { "searchQueries": { "title": "Search queries", "type": "array", "description": "Product search terms to run on the selected country shop. e.g. bags, jeans, boxers. Agents can pass natural-language keywords without collecting page URLs first. Ignored for a seed when that seed is a start URL.", "items": { "type": "string" } }, "startUrls": { "title": "Search or category URLs", "type": "array", "description": "Official Calvin Klein listing, search, or product URLs (e.g. https://www.calvinklein.de/search?searchTerm=bags or https://www.calvinklein.de/bestseller-herren). Country is inferred from the hostname when possible. Optional when searchQueries is set.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country shop", "enum": [ "AT", "BE", "CH", "CZ", "DE", "DK", "EE", "ES", "FI", "FR", "GB", "HR", "HU", "IE", "IT", "LT", "LU", "LV", "NL", "PL", "PT", "SE", "SI", "SK" ], "type": "string", "description": "Which official Calvin Klein shop to search. These are the country stores from the site picker (Germany, UK, France, Italy, Spain, Netherlands, and other European shops). The United States and Canada use a different website and are not in this list. Used for searchQueries; startUrls override the shop from the URL host.", "default": "DE" }, "language": { "title": "Language", "enum": [ "auto", "de", "en", "fr", "nl", "it", "es", "pl" ], "type": "string", "description": "Shop language when the country has more than one (e.g. German or English on calvinklein.de, Dutch or French on calvinklein.be). auto uses the default language for that country.", "default": "auto" }, "scrapeProductDetails": { "title": "Scrape product details", "type": "boolean", "description": "When enabled, fetch full product pages in parallel (description, size variants, stock flags). Charged as a separate product-details event. Off by default.", "default": false }, "detailsConcurrency": { "title": "Product details concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "How many product-detail requests to run at once. Each request uses a rotated proxy. Ignored when scrapeProductDetails is off.", "default": 8 }, "gender": { "title": "Gender", "enum": [ "any", "men", "women" ], "type": "string", "description": "Gender facet from the website filters. e.g. men, women.", "default": "any" }, "colors": { "title": "Colors", "type": "array", "description": "Color facet values from the website (e.g. black, blue, beige, brown). Multiple values are combined.", "items": { "type": "string" } }, "sizes": { "title": "Sizes", "type": "array", "description": "Size facet values from the website (e.g. S, M, L, XL, W32). You can also paste the site query token such as s.100492_s.", "items": { "type": "string" } }, "productGroups": { "title": "Product groups", "type": "array", "description": "Product group facet from the website (e.g. jeans, jacketsandcoats, t2dshirts). Matches filter chips such as Jeans or Jackets.", "items": { "type": "string" } }, "materials": { "title": "Materials", "type": "array", "description": "Material facet from the website (e.g. cotton, leather, nylon, fauxleather).", "items": { "type": "string" } }, "brands": { "title": "Brand labels", "type": "array", "description": "Brand facet from the website. e.g. Calvin Klein, Calvin Klein Jeans.", "items": { "type": "string" } }, "onSale": { "title": "On sale only", "type": "boolean", "description": "Restrict results to sale prices when the website sale filter is available.", "default": false }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Minimum price for the website price slider. Must be set together with maximum price. e.g. 20" }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Maximum price for the website price slider. Must be set together with minimum price. e.g. 150" }, "sortBy": { "title": "Sort by", "enum": [ "recommended", "bestsellers", "new_arrivals", "price_desc", "price_asc" ], "type": "string", "description": "Listing sort from the website. recommended is the default shop ranking.", "default": "recommended" }, "extraFilters": { "title": "Extra filters", "type": "object", "description": "Advanced facet map copied from the website API, keyed by facet id (e.g. {\"productgroup\": \"s.productgroup_jeans\", \"maincolour\": \"s.maincolour_black\"}). Merged on top of the named filters above." }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of products to scrape (0 = unlimited)", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are recommended for Calvin Klein catalog requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }