🇰🇿 Kaspi.kz Price Scraper & Monitor

✨ Overview

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.

Fast, cheap, and reliable.

🚀 How to use

✨ 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.

💡 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.

📝 Notes

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

👥 Для кого

▶️ 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

Pay-per-event: you are charged for each product card returned, plus Apify platform usage (compute + proxy, if you enable one). The current per-card price is shown in the Pricing section of this page. Use alertOnly=true in monitor mode to write (and pay for) only changed cards; the underlying scan is still billed as platform usage.

🇰🇿 KZ / Қазақша

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

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

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

🇷🇺 RU / На русском

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

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

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

🔗 Все наши акторы для данных по России, Казахстану и СНГ

Одна линейка для маркетплейсов, розничных сетей, госзакупок и проверки контрагентов - соседний актор открывается одним кликом по карточке.

💬 Вопросы и поддержка

Нашли ошибку или есть вопрос? Откройте тикет на вкладке Issues этого актора.