# Kaspi Product Search API Documentation

<p><strong>Kaspi Product Search API Documentation</strong> Search public logged-out Kaspi.kz products. Each card carries a first-party id accepted unchanged by product, offers and reviews, name, brand, KZT price with original and sale price and computed discount, rating, review count, seller, availability, a full-size image and an ISO 8601 creation date. Completions, facets and the total ship in the same answer. Each page has 12 cards. Filter by category code from the facets, brand and price range and sort by relevance, price, rating or new arrivals. A filter is also sent upstream and checked again on every row; when it is applied the total is null and pagination.filtered_client_side is true. One city per result set. Cost: 1 credit per successful request. A failed lookup costs nothing.</p>

- **Documentation:** [https://scrappa.co/docs/kaspi-api/kaspi_search](https://scrappa.co/docs/kaspi-api/kaspi_search)
- **API group:** Kaspi API
- **Endpoint:** `GET https://scrappa.co/api/kaspi/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Search text. Required. |
| `category` | string | No | Category code from the search facets. |
| `brand` | string | No | Brand value from search facets. |
| `min_price` | number | No | Minimum price in KZT. |
| `max_price` | number | No | Maximum price in KZT. |
| `price` | string | No | Price range such as 10000-50000. |
| `sort` | string | No | relevance, price-asc, price-desc, rating or created-desc. |
| `page` | integer | No | 1-based page number. |
| `city` | string | No | KATO city id such as 750000000. |

## Example response

```json
{
    "data": {
        "city": "750000000",
        "query": "iphone",
        "total": 3612,
        "facets": [],
        "results": [
            {
                "id": "180533183",
                "name": "Apple iPhone",
                "brand": "Apple",
                "image": "https://resources.cdn-kaspi.kz/img/1.jpg",
                "price": {
                    "sale": 749995,
                    "current": 749995,
                    "currency": "KZT",
                    "discount": 50000,
                    "original": 799995,
                    "is_on_sale": true,
                    "discount_percentage": 6.25
                },
                "rating": 4.8,
                "seller": "Kaspi",
                "availability": "available",
                "review_count": 120
            }
        ],
        "pagination": {
            "current_page": 1,
            "result_count": 30
        },
        "completions": [
            "iphone"
        ]
    },
    "meta": {
        "credits": 1,
        "billable": true
    },
    "success": true
}
```

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
