Kaspi.kz Price Scraper & Monitor 🇰🇿

Scrape and monitor product prices on Kaspi.kz, Kazakhstan's #1 marketplace (Kaspi Магазин). Get prices in KZT, Kaspi-bonus price, rating, review counts, stock, and installment plans, across multiple Kazakh cities in a single run. Unlike simple one-shot scrapers, this Actor has a monitor mode that tracks price changes between runs and a reviews-velocity signal for demand.

Built on Kaspi's own JSON API (no browser), so it is fast, cheap, and reliable.

Why this Actor

• Multi-city in one run - Kaspi prices and stock vary by city; scrape Almaty, Astana, Shymkent and more at once.
• Monitor mode - compare each run to the previous one and get price_up / price_down / new / removed with exact priceChangePct. Perfect for repricing and MAP monitoring.
• Reviews-velocity - reviewsDelta shows how fast a product gains reviews between runs: a proxy for sales velocity / demand.
• Webhook alerts - POST changes to your own endpoint (n8n, Make, Zapier) for Telegram/Slack alerts.
• Degradation alerts - flags cities that returned zero results while others worked.
• No browser - direct JSON API keeps runs fast and inexpensive.

Use cases

• Repricing / buy-box for Kaspi Магазин sellers - track competitors' prices per city.
• Brand MAP monitoring - detect sellers breaking minimum advertised price.
• Market research - category price levels, ratings, demand (reviews) across cities.
• Deal / price-drop alerts - monitor a basket of products and get notified on drops.

Input

Output (per product)

platform, query, id, title, brand, price (KZT), bonusPrice, rating, reviews, stock, monthlyInstallment, category, city, cityName, url, currency, scrapedAt

In monitor mode each item also has: changeType, previousPrice, priceChangePct, reviewsDelta.

Monitor setup

Run in monitor mode on an Apify Schedule (e.g. daily). The Actor stores state between runs, so each run reports what changed since the last one. Set notifyWebhookUrl to push alerts into your own workflow.

Quick start

Search mode - current listings across cities, with share-of-shelf:

{
  "mode": "search",
  "searchQueries": ["iphone 15", "холодильник"],
  "cities": ["750000000", "710000000"],
  "maxPagesPerQuery": 5,
  "shareOfShelf": true,
  "shareTopN": 20,
  "ownBrand": "Apple"
}

Monitor mode - price/rank deltas on a schedule, alert only on changes:

{
  "mode": "monitor",
  "searchQueries": ["iphone 15"],
  "cities": ["750000000"],
  "alertOnly": true,
  "priceChangeThresholdPct": 3,
  "rankDropThreshold": 3,
  "notifyWebhookUrl": "https://example.com/hooks/kaspi-alerts"
}

Set a schedule under Schedules in the Apify Console to run monitor mode periodically. State carries over between runs via the Key-Value Store.

Pricing

Direct JSON API, no browser - this keeps the Actor cheap: roughly $1.5 per 1000 product cards, plus Apify platform usage (compute + proxy, if you enable one). Use alertOnly=true in monitor mode to write (and pay for) only changed cards; the underlying scan is still billed as platform usage.

Notes

• Prices are in KZT and reflect the selected city.
• The API returns 12 products per page; use maxPagesPerQuery to control depth and cost.

KZ / Қазақша

Kaspi.kz - Қазақстанның №1 маркетплейсіндегі тауарлардың бағасын, рейтингін және іздеудегі орнын (рангін) қалалар бойынша жинау мен бақылау. Тікелей JSON-API, браузерсіз: арзан әрі сенімді.

• Бір жүгірісте бірнеше қала - Kaspi-дегі баға мен қолжетімділік қалаға қарай өзгереді; Алматы, Астана, Шымкент және басқаларын бір мезгілде жинаңыз.
• Мониторинг режимі - әр жүгіріс алдыңғысымен салыстырылып, price_up / price_down / new / removed және нақты priceChangePct беріледі. Repricing пен MAP-бақылау үшін ыңғайлы.
• Reviews-velocity - reviewsDelta пікірлердің қаншалықты тез жиналып жатқанын көрсетеді: сұраныс пен сату қарқынының белгісі.
• Share-of-shelf - сұраныс бойынша топ-N ішіндегі бренд пен сатушының көріну үлесі және өз брендіңіздің орындары.
• Webhook хабарламалары - өзгерістерді өз қызметіңізге (Telegram, n8n, Make) жіберіңіз.

Баға теңгемен (KZT) көрсетіледі және таңдалған қалаға сәйкес келеді. API бір бетте 12 тауардан береді; тереңдік пен шығынды maxPagesPerQuery арқылы реттеңіз. Актор Apify residential (KZ) прокси арқылы жұмыс істейді, трафикті іске қосушы төлейді.

RU / На русском

Мониторинг цен, рейтинга и позиции (ранга) товаров на Kaspi.kz - маркетплейсе №1 Казахстана - по городам. Прямой JSON-API, без браузера: дёшево и надёжно.

• Много городов за один прогон - цена, бонус-цена, рейтинг, отзывы и сток зависят от города; Алматы, Астана, Шымкент и другие - разом.
• Режим monitor - сравнивает текущий прогон с предыдущим и отдаёт price_up / price_down / new / removed с точным priceChangePct, плюс reviewsDelta (скорость набора отзывов - прокси спроса) и композитные алерты changeReasons вроде rank_drop (конкурент обошёл вас в выдаче) или undercut.
• Share-of-shelf - доля видимости бренда/продавца в топ-N выдачи по запросу и городу, включая позицию собственного бренда (ownBrand), отдельным датасетом.
• Вебхук - POST сводки изменений на свой эндпоинт (n8n/Make/Zapier → Telegram/Slack).
• Без браузера - Actor работает по собственному JSON-API Kaspi, поэтому быстрый и дешёвый.

Честные ограничения: только Kaspi.kz/Казахстан - другие площадки не поддерживаются; API отдаёт данные без прокси, но для стабильного казахстанского IP на Apify рекомендуется residential-прокси со страной KZ (поле proxyConfiguration); 12 товаров на странице API, глубина и стоимость регулируются maxPagesPerQuery. Тариф - по модели Pay-per-event, ориентировочно ~$1.5 за 1000 карточек плюс platform usage (compute/proxy) по правилам аккаунта Apify - прайс-мониторинг тут узкая ниша, поэтому цена держится низкой.