# Kaspi Product Details Scraper (`soft_alexist/kaspi-product-details-scraper`) Actor

Scrape detailed product information from Kaspi.kz, Central Asia's largest e-commerce platform. Extract pricing, specs, reviews, images, inventory, promotions, and 20+ fields per product — perfect for price monitoring, competitive analysis, and market research.

- **URL**: https://apify.com/soft\_alexist/kaspi-product-details-scraper.md
- **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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.kz Product Scraper: Extract E-commerce Data from Kazakhstan's Leading Marketplace

***

### About Kaspi.kz

Kaspi.kz is Kazakhstan's premier online marketplace, hosting millions of products across electronics, appliances, fashion, and more. It serves as a critical sales channel for retailers and brands across Central Asia. Monitoring product data — prices, inventory, promotions, and ratings — is essential for competitive positioning, but manual tracking is inefficient. The **Kaspi.kz Product Scraper** automates this process, delivering structured product datasets in minutes.

***

### Overview

The **Kaspi Product Details Scraper** extracts comprehensive product pages from Kaspi.kz, converting listings into clean, machine-readable records. It is designed for:

- **E-commerce businesses** monitoring competitor pricing and promotions
- **Price intelligence platforms** tracking market trends on Kaspi
- **Retailers** managing multichannel inventory and pricing strategy
- **Researchers** analyzing product catalogs and consumer market dynamics

The scraper captures 20+ fields per product, including pricing tiers, discounts, credit options, media assets, and promotional metadata — everything needed for data-driven decisions.

***

### Input Format

The scraper accepts a JSON configuration specifying product URLs and runtime behavior:

```json
{
  "urls": [
    "https://kaspi.kz/shop/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/?c=750000000",
    "https://kaspi.kz/shop/p/mfu-canon-pixma-g2470-5804c009-109149250/?c=750000000",
    "https://kaspi.kz/shop/p/acer-aspire-3-15-6-16-gb-ssd-512-gb-win-11-pro-a315-59-52x6-nx-k6ter-001w-120936355/?c=750000000"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}
```

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | Direct links to Kaspi.kz product detail pages. Paste full URLs including the product ID and category parameter (`?c=...`). Supports bulk entry. |
| `max_items_per_url` | Number | Maximum data records extracted per URL (e.g., `200`). Set higher for comprehensive product data. |
| `ignore_url_failures` | Boolean | If `true`, scraper skips failed URLs and continues. If `false`, any URL error stops the run. Recommended: `true` for batch operations. |

> **Best practice:** Include the category parameter (`?c=750000000`) in URLs for consistent data extraction.

***

### Output Format

**Sample output**

```json
{
  "id": "104636043",
  "title": "Стабилизатор напряжения SVC SVC R-600",
  "created_time": "2022-04-26T06:15:00.914+00:00",
  "shop_link": "/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/",
  "category_id": "05305",
  "currency": "",
  "reviews_link": "/shop/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/?c=750000000&v=reviews",
  "button_in_cart": {
    "title": "Перейти в корзину",
    "description": "Товар в корзине"
  },
  "max_quantity": 10,
  "unit": {
    "code": "pieces",
    "type": "PIECES",
    "measurement_literal": "шт",
    "counting_literal": "шт",
    "increment": 1
  },
  "promo_conditions": {
    "brand": "SVC",
    "category_codes": [
      "UPS",
      "Peripherals",
      "Computers",
      "Categories"
    ],
    "base_product_codes": [
      "[Master - Stabilizers][svc]{R}"
    ],
    "groups": null,
    "product_series": []
  },
  "stickers": null,
  "price": 16990,
  "discount": 0,
  "unit_price_before_discount": 16990,
  "credit_monthly_price": "2 832 ₸",
  "video_id": null,
  "gallery_images": [
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/h47/hd0/64575616286750.jpg?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/h47/hd0/64575616286750.jpg?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/h47/hd0/64575616286750.jpg?format=gallery-large",
      "location": "h47/hd0/64575616286750.jpg",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/pba/ped/143750392.png?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/pba/ped/143750392.png?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/pba/ped/143750392.png?format=gallery-large",
      "location": "pba/ped/143750392.png",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/pad/p17/93191389.jpg?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/pad/p17/93191389.jpg?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/pad/p17/93191389.jpg?format=gallery-large",
      "location": "pad/p17/93191389.jpg",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/p32/pe2/142620525.png?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/p32/pe2/142620525.png?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/p32/pe2/142620525.png?format=gallery-large",
      "location": "p32/pe2/142620525.png",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/pdd/pe1/142620528.png?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/pdd/pe1/142620528.png?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/pdd/pe1/142620528.png?format=gallery-large",
      "location": "pdd/pe1/142620528.png",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/pc1/pe1/142620529.png?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/pc1/pe1/142620529.png?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/pc1/pe1/142620529.png?format=gallery-large",
      "location": "pc1/pe1/142620529.png",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/p1d/pdf/142620532.png?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/p1d/pdf/142620532.png?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/p1d/pdf/142620532.png?format=gallery-large",
      "location": "p1d/pdf/142620532.png",
      "generated": false,
      "visual_type": null
    },
    {
      "small": "https://resources.cdn-kaspi.kz/img/m/p/h14/hc2/64575618973726.jpg?format=gallery-small",
      "medium": "https://resources.cdn-kaspi.kz/img/m/p/h14/hc2/64575618973726.jpg?format=gallery-medium",
      "large": "https://resources.cdn-kaspi.kz/img/m/p/h14/hc2/64575618973726.jpg?format=gallery-large",
      "location": "h14/hc2/64575618973726.jpg",
      "generated": false,
      "visual_type": null
    }
  ],
  "description": "<p>Автоматический однофазный стабилизатор напряжения релейного типа SVC R-600</p><br><p>Применяется для стабилизации выходного напряжения в сетях с однофазным переменным током, частотой 50 Гц. Предотвращает выход из строя электроники на бытовых приборах мощностью до 600 ВА, вследствие колебания напряжения в сети переменного тока. Рекомендуется к применению для защиты управляющей электроники двухконтурных энергозависимых газовых котлов, для защиты компьютерного оборудования и бытовой техники.</p>",
  "descriptions": [
    {
      "title": "Описание",
      "text": "<p>Автоматический однофазный стабилизатор напряжения релейного типа SVC R-600</p><br><p>Применяется для стабилизации выходного напряжения в сетях с однофазным переменным током, частотой 50 Гц. Предотвращает выход из строя электроники на бытовых приборах мощностью до 600 ВА, вследствие колебания напряжения в сети переменного тока. Рекомендуется к применению для защиты управляющей электроники двухконтурных энергозависимых газовых котлов, для защиты компьютерного оборудования и бытовой техники.</p>",
      "ai_generated": false
    }
  ],
  "specifications": [
    {
      "code": "UPS*Input-Output",
      "name": "Вход-Выход",
      "features": [
        {
          "code": "product code",
          "name": "Код товара:",
          "may_copy": true,
          "feature_values": [
            {
              "value": "104636043"
            }
          ]
        },
        {
          "code": "ups*input voltage",
          "name": "Входное напряжение",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "1-фазное"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 17,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*output voltage",
          "name": "Выходное напряжение",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "1-фазное"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 18,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*min. input voltage",
          "name": "Мин. входное напряжение",
          "description": null,
          "type": "NUMBER",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "140 В"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 19,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*max. input voltage",
          "name": "Макс. входное напряжение",
          "description": null,
          "type": "NUMBER",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "260 В"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 20,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        }
      ],
      "position": 0
    },
    {
      "code": "UPS*Specifications",
      "name": "Технические характеристики",
      "features": [
        {
          "code": "ups*view",
          "name": "Вид",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "стабилизатор напряжения"
            }
          ],
          "mandatory": true,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 0,
          "visible": true,
          "multi_valued": false,
          "important": true,
          "importance_score": 1
        },
        {
          "code": "ups*type",
          "name": "Тип",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "релейный"
            }
          ],
          "mandatory": true,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 1,
          "visible": true,
          "multi_valued": false,
          "important": true,
          "importance_score": null
        },
        {
          "code": "ups*racking option",
          "name": "Возможность установки в стойку",
          "description": null,
          "type": null,
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "false"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 2,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*output #gross#",
          "name": "Выходная мощность (полная)",
          "description": null,
          "type": "NUMBER",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "600 ВА"
            }
          ],
          "mandatory": true,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 3,
          "visible": true,
          "multi_valued": false,
          "important": true,
          "importance_score": null
        },
        {
          "code": "ups*output #active#",
          "name": "Выходная мощность (активная)",
          "description": null,
          "type": "NUMBER",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "500 Вт"
            }
          ],
          "mandatory": true,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 4,
          "visible": true,
          "multi_valued": false,
          "important": true,
          "importance_score": null
        },
        {
          "code": "ups*number of power connectors",
          "name": "Количество разъемов питания",
          "description": null,
          "type": "NUMBER",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "2"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 11,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*power connectors type",
          "name": "Тип выходных разъемов питания",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "CEE 7 (евророзетка)"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 12,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*protection",
          "name": "Защита",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "защита от всплесков напряжения"
            },
            {
              "value": "защита от повышенного напряжения"
            },
            {
              "value": "защита от низкого напряжения"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 13,
          "visible": true,
          "multi_valued": true,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*battery replacement",
          "name": "Замена батареи",
          "description": null,
          "type": null,
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "false"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 14,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*batter hot swap",
          "name": "Горячая замена батареи",
          "description": null,
          "type": null,
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "false"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 15,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        }
      ],
      "position": 0
    },
    {
      "code": "UPS*Additional information",
      "name": "Дополнительная информация",
      "features": [
        {
          "code": "ups*dimensions #wxhxd#",
          "name": "Габариты (ШхВхГ)",
          "description": null,
          "type": "STRING",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "120*150*222"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 3,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*weight",
          "name": "Вес",
          "description": null,
          "type": "NUMBER",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "2.7 кг"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 4,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        }
      ],
      "position": 0
    },
    {
      "code": "UPS*Control",
      "name": "Управление",
      "features": [
        {
          "code": "ups*information display",
          "name": "Отображение информации",
          "description": null,
          "type": "ENUM",
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "LED-дисплей"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 23,
          "visible": true,
          "multi_valued": false,
          "important": false,
          "importance_score": null
        },
        {
          "code": "ups*slot for additional interfaces",
          "name": "Слот для дополнительных интерфейсов",
          "description": null,
          "type": null,
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "false"
            }
          ],
          "mandatory": false,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 25,
          "visible": true,
          "multi_valued": false,
          "important": null,
          "importance_score": null
        },
        {
          "code": "ups*alarm",
          "name": "Звуковая сигнализация",
          "description": null,
          "type": null,
          "range": null,
          "comparable": null,
          "feature_unit": null,
          "feature_values": [
            {
              "value": "true"
            }
          ],
          "mandatory": true,
          "key_attribute": false,
          "merchant_visible": null,
          "position": 26,
          "visible": true,
          "multi_valued": false,
          "important": true,
          "importance_score": null
        }
      ],
      "position": 0
    }
  ],
  "size_table_code": null,
  "certificate": null,
  "rich_content": null,
  "videos": [],
  "teasers": []
}
```

Each scraped product returns a detailed record with 20+ fields covering identification, pricing, inventory, media, and promotional details:

#### Product Identification

| Field | Meaning |
|---|---|
| `ID` | Unique Kaspi product identifier (internal SKU) |
| `Title` | Product name as displayed on the listing page |
| `Shop Link` | Direct URL to the seller's shop profile on Kaspi |
| `Category ID` | Numeric code for the product category |

#### Pricing & Financial Data

| Field | Meaning |
|---|---|
| `Price` | Current listed price in Tenge (KZT) |
| `Discount` | Absolute discount amount (e.g., 5000 KZT) |
| `Unit Price Before Discount` | Original price before any promotional reduction |
| `Credit Monthly Price` | Monthly installment price via Kaspi Credit (interest-free finance option) |
| `Currency` | Currency code (KZT for Kazakhstani Tenge) |

#### Inventory & Purchase Options

| Field | Meaning |
|---|---|
| `Max Quantity` | Maximum units a customer can purchase per order |
| `Unit` | Unit of measurement (e.g., pcs, kg, m) |
| `Button In Cart` | Text label on the "Add to Cart" button (reflects availability status) |

#### Promotions & Offers

| Field | Meaning |
|---|---|
| `Promo Conditions` | Active promotional conditions (e.g., "Free shipping over 10,000 KZT") |
| `Stickers` | Promotional badges/labels (e.g., "NEW", "HOT DEAL", "LIMITED") |

#### Media & Content

| Field | Meaning |
|---|---|
| `Gallery Images` | Array of product image URLs (thumbnails, full views, lifestyle shots) |
| `Video ID` | Embedded video ID (if product has promotional video) |
| `Videos` | Video content metadata and playback URLs |

#### Detailed Product Information

| Field | Meaning |
|---|---|
| `Description` | Primary product description (summary) |
| `Descriptions` | Detailed multi-section descriptions and benefits |
| `Specifications` | Technical specs table (dimensions, weight, materials, performance metrics, etc.) |
| `Size Table Code` | Size/fit guide reference (for clothing, footwear) |
| `Certificate` | Certification and compliance documentation links |
| `Rich Content` | Structured content blocks (features, benefits, usage tips) |
| `Teasers` | Promotional teaser text and countdown timers |

#### Administrative

| Field | Meaning |
|---|---|
| `Created Time` | Timestamp when the product listing was first published |
| `Reviews Link` | Direct link to the product reviews and ratings section |

***

### How to Use

1. **Collect product URLs** — Browse Kaspi.kz, find products of interest, and copy the full product page URL (e.g., `https://kaspi.kz/shop/p/[product-name]/[product-id]/?c=...`).

2. **Prepare input** — Paste URLs into the `urls` array. Use bulk edit to add multiple URLs at once.

3. **Configure limits** — Set `max_items_per_url` to control data volume (typically `200` is sufficient). Enable `ignore_url_failures` to skip broken or outdated URLs.

4. **Start the scraper** — Execute the run and monitor the progress log for any warnings.

5. **Export results** — Download output as JSON, CSV, or Excel. Import into your database, BI tool, or spreadsheet for analysis.

**Tips & troubleshooting:**

- If a URL returns limited data, verify the product is still active and not delisted.
- Product IDs may change if listings are refreshed; update URLs periodically.
- Use consistent category filters (`?c=`) across URLs for comparable datasets.
- If `Reviews Link` field is empty, the product may have no published reviews yet.

***

### Use Cases & Business Value

- **Price intelligence:** Monitor competitor pricing, discounts, and promotions in real-time
- **Inventory tracking:** Track stock availability and product status across sellers
- **Promotional analysis:** Identify trending offers, seasonal discounts, and bundle deals
- **Market research:** Build product databases for category analysis and trend forecasting
- **Competitive benchmarking:** Compare specs, features, and pricing across similar products

By automating product data collection, the Kaspi scraper eliminates hours of manual work, enabling data-driven decisions on pricing strategy, inventory management, and market positioning.

***

### Conclusion

The **Kaspi.kz Product Scraper** is an essential tool for e-commerce professionals, price researchers, and competitive intelligence teams. With 20+ structured fields covering pricing, promotions, inventory, and media, it transforms Kaspi.kz listings into actionable data. Start scraping today and gain the competitive edge your business needs.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific product urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## Actor input object example

```json
{
  "urls": [
    "https://kaspi.kz/shop/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/?c=750000000",
    "https://kaspi.kz/shop/p/mfu-canon-pixma-g2470-5804c009-109149250/?c=750000000",
    "https://kaspi.kz/shop/p/acer-aspire-3-15-6-16-gb-ssd-512-gb-win-11-pro-a315-59-52x6-nx-k6ter-001w-120936355/?c=750000000",
    "https://kaspi.kz/shop/p/asus-vivobook-16x-16-16-gb-ssd-512-gb-win-11-90nb1071-m00at0-129951243/?c=750000000",
    "https://kaspi.kz/shop/p/acer-nitro-lite-nl16-71g-16-16-gb-ssd-512-gb-bez-os-nh-daaer-001-148703886/?c=750000000"
  ],
  "ignore_url_failures": true
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://kaspi.kz/shop/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/?c=750000000",
        "https://kaspi.kz/shop/p/mfu-canon-pixma-g2470-5804c009-109149250/?c=750000000",
        "https://kaspi.kz/shop/p/acer-aspire-3-15-6-16-gb-ssd-512-gb-win-11-pro-a315-59-52x6-nx-k6ter-001w-120936355/?c=750000000",
        "https://kaspi.kz/shop/p/asus-vivobook-16x-16-16-gb-ssd-512-gb-win-11-90nb1071-m00at0-129951243/?c=750000000",
        "https://kaspi.kz/shop/p/acer-nitro-lite-nl16-71g-16-16-gb-ssd-512-gb-bez-os-nh-daaer-001-148703886/?c=750000000"
    ],
    "ignore_url_failures": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("soft_alexist/kaspi-product-details-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": [
        "https://kaspi.kz/shop/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/?c=750000000",
        "https://kaspi.kz/shop/p/mfu-canon-pixma-g2470-5804c009-109149250/?c=750000000",
        "https://kaspi.kz/shop/p/acer-aspire-3-15-6-16-gb-ssd-512-gb-win-11-pro-a315-59-52x6-nx-k6ter-001w-120936355/?c=750000000",
        "https://kaspi.kz/shop/p/asus-vivobook-16x-16-16-gb-ssd-512-gb-win-11-90nb1071-m00at0-129951243/?c=750000000",
        "https://kaspi.kz/shop/p/acer-nitro-lite-nl16-71g-16-16-gb-ssd-512-gb-bez-os-nh-daaer-001-148703886/?c=750000000",
    ],
    "ignore_url_failures": True,
}

# Run the Actor and wait for it to finish
run = client.actor("soft_alexist/kaspi-product-details-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 '{
  "urls": [
    "https://kaspi.kz/shop/p/stabilizator-naprjazhenija-svc-svc-r-600-104636043/?c=750000000",
    "https://kaspi.kz/shop/p/mfu-canon-pixma-g2470-5804c009-109149250/?c=750000000",
    "https://kaspi.kz/shop/p/acer-aspire-3-15-6-16-gb-ssd-512-gb-win-11-pro-a315-59-52x6-nx-k6ter-001w-120936355/?c=750000000",
    "https://kaspi.kz/shop/p/asus-vivobook-16x-16-16-gb-ssd-512-gb-win-11-90nb1071-m00at0-129951243/?c=750000000",
    "https://kaspi.kz/shop/p/acer-nitro-lite-nl16-71g-16-16-gb-ssd-512-gb-bez-os-nh-daaer-001-148703886/?c=750000000"
  ],
  "ignore_url_failures": true
}' |
apify call soft_alexist/kaspi-product-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=soft_alexist/kaspi-product-details-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/kDMlSneb2Ml9Df02P/builds/tLwrbV9gftqwGUpwl/openapi.json
