# Kaspi Product Scraper: Kaspi Магазин (Kazakhstan) (`getascraper/kaspi-product-scraper`) Actor Scrape products, prices, Kaspi bonus, installments, ratings, and stock from Kaspi.kz (Kaspi Магазин), Kazakhstan's #1 marketplace. Search by keyword in Russian or Kazakh across 6 cities. - **URL**: https://apify.com/getascraper/kaspi-product-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.66 / 1,000 products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🛒 Kaspi Product Scraper: Kaspi Магазин (Казахстан)
Track every Kaspi.kz price without opening a single product page.
Pull live prices, the Kaspi bonus price, installments, ratings, and stock from Kaspi Магазин, Kazakhstan's #1 marketplace. Search in Russian or Kazakh, across 6 cities, and get one clean spreadsheet.
💳 Kaspi bonus
The real net price after bonus, on every product 		🏙️ 6 cities
Prices and stock per city, Almaty to Aktau 		📅 Installments
Monthly credit and installment on each row 		⭐ Ratings
Star rating and review count, ready to sort
Checking Kaspi prices one product at a time takes all afternoon. This Actor does it in seconds. Point it at a keyword like "iphone", "холодильник", or "қыздырғыш", pick a city, and get every top result from [Kaspi Магазин](https://kaspi.kz/shop/) as clean rows: price, Kaspi bonus, installment, rating, stock, and delivery. Ready for price tracking, market research, or a product database. ### 🔍 What does Kaspi Product Scraper do? It reads the public Kaspi.kz catalog and returns the data buyers actually act on. For every product you get the current price, the price after Kaspi bonus, credit and installment options, star rating, review count, stock status, delivery time, brand, and category. Everything lands as flat rows you can download as Excel, CSV, or JSON, or send straight to a Google Sheet. ### 💡 Who is it for? "I resell on Kaspi, so I need the market's live prices before I set mine." "I research Kazakhstan retail, so I want pricing, bonus, and assortment across cities in one export." "I sell my brand on Kaspi, so I check my products' prices, ratings, and stock in one run." "I build a price or deals tool, so I feed live Kaspi.kz data into my database on a schedule." ### 🚀 How to use it
STEP 1
Add your keywords
In Russian or Kazakh, then pick a city. 		STEP 2
Run or schedule
Start once, or set a daily schedule. 		STEP 3
Export anywhere
Excel, CSV, JSON, Google Sheets, or Slack.
### ⚙️ Input | Field | Type | Required | Description | |---|---|---|---| | `searchQueries` | array of text | No | Keywords to search on Kaspi.kz, in Russian or Kazakh, e.g. "iphone", "холодильник". Each keyword is resolved independently. | | `startUrls` | array of URLs | No | Direct Kaspi search URLs, e.g. https://kaspi.kz/shop/search/?text=iphone. The keyword is read from the URL. | | `city` | enum | No | City for prices, Kaspi bonus, stock, and delivery: Almaty, Astana, Shymkent, Karaganda, Aktobe, or Aktau. | | `maxItems` | integer | No | Maximum total product rows returned. 0 means unlimited. | | `maxPagesPerQuery` | integer | No | Result pages per keyword. Kaspi returns up to 24 top products per keyword. | | `proxyConfiguration` | object | No | Proxy settings. Datacenter (the default) is fast, cheap, and reliable for Kaspi. | ### 📦 Output Each row is one product, with price, Kaspi bonus, rating, and stock. Download as JSON, CSV, or Excel. ```json [ { "productId": "145467625", "title": "Apple iPhone 17 Pro 256Gb NanoSIM+eSIM оранжевый", "brand": "Apple", "url": "https://kaspi.kz/p/apple-iphone-17-pro-256gb-nanosim-esim-oranzhevyi-145467625/?c=750000000", "price": 786499, "priceWithBonus": 762905, "creditMonthlyPrice": 32771, "monthlyInstallment": "32 771 ₸", "rating": 4.9, "reviewsQuantity": 1762, "inStock": true, "stockCount": 1, "deliveryDuration": "TODAY", "category": ["Телефоны и гаджеты", "Смартфоны"], "image": "https://resources.cdn-kaspi.kz/img/m/p/p18/p96/64168413.png", "cityName": "Алматы", "currency": "KZT", "scrapedAt": "2026-07-08T00:02:24.004Z" } ] ```` ### 📊 Data table | Field | Type | Description | |---|---|---| | `productId` | string | Kaspi product ID. | | `title` | string | Product name. | | `brand` | string | Product brand. | | `url` | string | Link to the product page. | | `price` | number | Current price in tenge. | | `priceWithBonus` | number | Price after Kaspi bonus deduction. | | `creditMonthlyPrice` | number | Monthly credit payment. | | `monthlyInstallment` | string | Monthly installment amount. | | `rating` | number | Average customer rating. | | `reviewsQuantity` | number | Number of customer reviews. | | `inStock` | boolean | Whether the product is available. | | `stockCount` | number | Units in stock. | | `deliveryDuration` | string | Delivery speed, e.g. TODAY or TOMORROW. | | `category` | array of text | Category path. | | `image` | string | Main product image URL. | | `cityName` | string | City the prices apply to. | | `currency` | string | Price currency (KZT). | | `scrapedAt` | string | Timestamp of when the row was collected. | ### 💰 Pricing Pricing is pay per result. You only pay for the product rows the Actor actually returns, so an empty run costs nothing. There are no subscriptions and no minimum spend. Run it once for a one-off export, or schedule it and only pay for the products you collect. ### ⭐ Enjoying Kaspi Product Scraper?
⭐ ⭐ ⭐ ⭐ ⭐
If this Actor saved you an afternoon, leave a quick review.
A 5-star rating takes 10 seconds and helps other Kazakhstan sellers, resellers, and researchers find it. Your feedback also tells us what to build next.
★  Rate this Actor on Apify
### ✨ Tips - Kaspi returns the top 24 most-relevant products per keyword. For wider coverage, run several specific keywords instead of one broad term. - Prices, Kaspi bonus, and stock differ by city, so run the same keywords across cities to compare. - Search in Russian or Kazakh, whichever matches how you think about the product. - Schedule the Actor in Apify to build a running price history without touching a spreadsheet. ### ❓ FAQ ##### Как узнать цены и Kaspi бонус на Kaspi.kz? Add your keywords, pick a city, and run the Actor. Each product comes back with its price, the price after Kaspi bonus, installment options, rating, and stock. ##### Қазақ тілінде іздеуге бола ма? Yes. Search keywords work in both Kazakh and Russian, and results include Russian product names and categories. ##### How many products can it return per keyword? Kaspi serves up to 24 top-relevance products per keyword. To collect more, add more specific keywords or run the same term across several cities. ##### Do I need a Kaspi account? No. The Actor reads only public product and price data. No login or account required. ##### Is it legal to scrape Kaspi.kz? This Actor collects publicly available product and pricing data that Kaspi already displays on its own pages. You are responsible for following Kaspi's terms of service and any applicable data-protection laws in your jurisdiction. ### 🔗 Other actors - [Wildberries Scraper](https://apify.com/getascraper/wildberries-scraper) ↗ - product search, catalog, and price data from Wildberries. - [Yandex Market Scraper](https://apify.com/getascraper/yandex-market-scraper) ↗ - product listings and prices from Yandex Market. - [Uzum Scraper](https://apify.com/getascraper/uzum-scraper) ↗ - marketplace product and price data from Uzbekistan's Uzum. - [Magnit Market Scraper](https://apify.com/getascraper/magnit-market-scraper) ↗ - product and price data from KazanExpress/Magnit Market. - [Detmir Scraper](https://apify.com/getascraper/detmir-scraper) ↗ - product listings and prices from Detmir (Детский Мир). # Actor input Schema ## `searchQueries` (type: `array`): Keywords to search on Kaspi.kz, in Russian or Kazakh, e.g. 'iphone', 'холодильник', 'қыздырғыш'. Each keyword is resolved independently. ## `startUrls` (type: `array`): Direct Kaspi.kz search URLs to scrape, e.g. https://kaspi.kz/shop/search/?text=iphone. The keyword is read from the URL. ## `city` (type: `string`): Kaspi city. Prices, Kaspi bonus, stock, and delivery vary by city. ## `maxItems` (type: `integer`): Hard limit on total product rows returned across all queries. Set 0 for unlimited. ## `maxPagesPerQuery` (type: `integer`): Result pages fetched per keyword or URL (12 products per page). Kaspi returns up to 2 pages (24 top-relevance products) per keyword. For wider coverage, add more specific keywords. ## `proxyConfiguration` (type: `object`): Proxy settings. Datacenter (the default) is fast and cheap and works reliably for Kaspi's public catalog. ## Actor input object example ```json { "searchQueries": [ "iphone" ], "startUrls": [], "city": "750000000", "maxItems": 100, "maxPagesPerQuery": 2, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchQueries": [ "iphone" ], "startUrls": [], "city": "750000000", "maxItems": 100, "maxPagesPerQuery": 2, "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/kaspi-product-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": ["iphone"], "startUrls": [], "city": "750000000", "maxItems": 100, "maxPagesPerQuery": 2, "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("getascraper/kaspi-product-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "iphone" ], "startUrls": [], "city": "750000000", "maxItems": 100, "maxPagesPerQuery": 2, "proxyConfiguration": { "useApifyProxy": true } }' | apify call getascraper/kaspi-product-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/kaspi-product-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kaspi Product Scraper: Kaspi Магазин (Kazakhstan)", "description": "Scrape products, prices, Kaspi bonus, installments, ratings, and stock from Kaspi.kz (Kaspi Магазин), Kazakhstan's #1 marketplace. Search by keyword in Russian or Kazakh across 6 cities.", "version": "0.1", "x-build-id": "rNzeUCLf0KbXlgTyS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~kaspi-product-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-kaspi-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/getascraper~kaspi-product-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-kaspi-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/getascraper~kaspi-product-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-kaspi-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", "properties": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to search on Kaspi.kz, in Russian or Kazakh, e.g. 'iphone', 'холодильник', 'қыздырғыш'. Each keyword is resolved independently.", "default": [ "iphone" ], "items": { "type": "string" } }, "startUrls": { "title": "Kaspi search URLs", "type": "array", "description": "Direct Kaspi.kz search URLs to scrape, e.g. https://kaspi.kz/shop/search/?text=iphone. The keyword is read from the URL.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "city": { "title": "City", "enum": [ "750000000", "710000000", "511010000", "351010000", "151010000", "471010000" ], "type": "string", "description": "Kaspi city. Prices, Kaspi bonus, stock, and delivery vary by city.", "default": "750000000" }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Hard limit on total product rows returned across all queries. Set 0 for unlimited.", "default": 100 }, "maxPagesPerQuery": { "title": "Max pages per query", "minimum": 1, "maximum": 2, "type": "integer", "description": "Result pages fetched per keyword or URL (12 products per page). Kaspi returns up to 2 pages (24 top-relevance products) per keyword. For wider coverage, add more specific keywords.", "default": 2 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Datacenter (the default) is fast and cheap and works reliably for Kaspi's public catalog.", "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 } } }, "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 } } } } } } } } } } ```