{ "openapi": "3.0.1", "info": { "title": "Kaspi.kz Products Scraper", "description": "Products from Kaspi.kz, Kazakhstan's largest marketplace: price, bonus price, installments, merchants, rating and per-city delivery. The city is validated against Kaspi's own list of 320 first -- an unknown one is answered by Almaty, not by an error.", "version": "0.1", "x-build-id": "rV4pChuasdx3Fk4On" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~kaspi-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-kaspi-products-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/scrapyx~kaspi-products-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-kaspi-products-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/scrapyx~kaspi-products-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-kaspi-products-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "What to search for on Kaspi - 'ноутбук', 'iphone 15', 'холодильник'. Each term becomes its own target with its own summary row. An empty term is refused here rather than sent: Kaspi answers one with a generic twelve-product catalogue instead of an error, which is the failure mode that looks like a working run.", "items": { "type": "string" } }, "city": { "title": "City", "type": "string", "description": "A Kaspi city slug, Russian name or numeric id - almaty, astana, shymkent, 750000000. Leave empty for Almaty, Kaspi's own default. IMPORTANT: Kaspi does NOT reject an unknown city id; it answers with the default city and twelve real products. Every value is therefore checked against Kaspi's own list of 320 cities first. Note also that the city changes DELIVERY WINDOWS only - prices on this endpoint are national, and every run reports the delivery windows it actually saw as evidence the city took effect." }, "onlyDiscounted": { "title": "Only discounted products", "type": "boolean", "description": "Keep only products whose sale price is below their list price.", "default": false }, "includePromoted": { "title": "Include sponsored products", "type": "boolean", "description": "Kaspi returns sponsored placements in their own keys rather than mixed into the results, which is unusually honest. They are excluded by default; enabling this adds them, flagged with isPromoted.", "default": false }, "maxItems": { "title": "Max products", "minimum": 1, "maximum": 3600, "type": "integer", "description": "Overall cap on product rows across every search term. Kaspi serves 12 products per page and refuses page 301 with a message-less HTTP 400, so a single search term tops out at about 3,600 products however deep you page. A run that reaches that wall reports ceilingHit.", "default": 240 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 6, "type": "integer", "description": "Parallel requests across search terms.", "default": 2 }, "minRequestInterval": { "title": "Min seconds between requests", "minimum": 0, "maximum": 20, "type": "integer", "description": "Politeness delay between request starts. It paces starts only and does not hold a concurrency slot, so raising it slows the run without idling workers.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "ON by default, and it needs to be. Kaspi answers HTTP 429 to the IP an Apify run egresses from directly - a cloud run without a proxy fails every request, while the same code from a residential IP succeeds on the first attempt. Apify's FREE datacenter proxy clears it completely (verified: 429 without, 200 with), so this costs nothing. Leave the pool unpinned: the city travels in the query string, not in the exit IP.", "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 }, "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 } } } } } } } } } }