krisha.kz APIkrisha.kz ↗
Search and retrieve property listings from krisha.kz. Access sale and rental data for apartments, houses, and commercial properties across Kazakhstan.
curl -X GET 'https://api.parse.bot/scraper/320b67d0-20cf-468a-a587-d9fd52942a2d/search_listings?city=almaty&page=1&rooms=2%2C3&deal_type=prodazha&property_type=kvartiry' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate listings (sale or rent) with optional filters for city, rooms, and price range. Returns paginated results with listing summaries.
| Param | Type | Description |
|---|---|---|
| city | string | City slug (e.g., 'almaty', 'astana'). Omitting returns listings from all cities. |
| page | integer | Page number for pagination. |
| rooms | string | Number of rooms to filter by, comma-separated for multiple values (e.g., '2' or '2,3'). |
| price_to | integer | Maximum price filter in tenge. |
| deal_type | string | Type of deal: 'prodazha' (sale) or 'arenda' (rent). |
| price_from | integer | Minimum price filter in tenge. |
| property_type | string | Property type: 'kvartiry' (apartments), 'doma-dachi' (houses), 'kommercheskie' (commercial), 'uchastki' (land plots), 'garazhi' (garages). |
{
"type": "object",
"fields": {
"listings": "array of listing objects with id, price_text, title, subtitle, description_snippet",
"listing_ids": "array of integer listing IDs",
"total_count": "string with total number of matching listings",
"current_page": "integer indicating the current page number"
},
"sample": {
"data": {
"listings": [
{
"id": "1011901990",
"price_text": "от 36 380 084 ₸"
},
{
"id": "1009263237",
"price_text": "36 000 000 ₸"
}
],
"listing_ids": [
1011901990,
1009263237
],
"total_count": "27 481",
"current_page": 1
},
"status": "success"
}
}About the krisha.kz API
The Krisha.kz API exposes 3 endpoints for searching and retrieving property listings from Kazakhstan's largest real estate marketplace. Use search_listings to query apartments, houses, land, and commercial properties by city, deal type, room count, and price range, then pull full listing details — including coordinates, photos, area, and seller information — via get_listing_detail.
What the API covers
The Krisha.kz API gives structured access to sale and rental listings across Kazakhstan. search_listings accepts filters for city (slug values like almaty or astana), deal_type (prodazha for sale, arenda for rent), property_type (kvartiry, doma-dachi, kommercheskie, uchastki), rooms (comma-separated values), and price_from/price_to in tenge. Responses include a listings array with per-listing id, price_text, title, subtitle, and description_snippet, along with a flat listing_ids array and a total_count string for pagination planning.
Listing detail data
get_listing_detail takes a listing_id from search results and returns the full advert object: price, addressTitle, square, rooms, photos, map coordinates, description, and ownerName. The adverts array adds card-level data including fullAddress and priceM2 (price per square meter), which is useful for comparative analysis across neighborhoods.
Contact information
get_listing_contact returns owner_name, user_type (distinguishing private owners from agents), and the listing_id. Full phone numbers are not returned directly — the response includes a phones_url path and a note that phone retrieval requires solving a reCAPTCHA challenge on the source site. Plan your contact-retrieval workflows around this constraint.
- Aggregate apartment listings in Almaty and Astana filtered by room count and price range for a property search app
- Track price-per-square-meter trends across neighborhoods using the
priceM2field fromget_listing_detail - Identify whether a listing is from a private owner or an agent using the
user_typefield inget_listing_contact - Build a map-based property browser using
mapcoordinates returned in theadvertobject - Monitor new commercial property listings (
kommercheskie) in a target city by pollingsearch_listingswithdeal_typeandproperty_typefilters - Compare land listings (
uchastki) for sale within a defined tenge price band across multiple cities
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does krisha.kz have an official developer API?+
What does `search_listings` return and how does pagination work?+
search_listings returns a listings array with summary fields (id, price_text, title, subtitle, description_snippet), a flat listing_ids array, a total_count string, and a current_page integer. Use the page parameter to iterate through results. total_count is returned as a string, so parse it to an integer before using it for page-count arithmetic.Can I retrieve full phone numbers for listing owners?+
get_listing_contact returns owner_name and user_type without requiring any challenge, but full phone numbers are gated behind a reCAPTCHA on the source site. The phones_url field points to where phone data can be fetched, but automated retrieval of phone numbers is not supported by this API.Does the API cover new-development (zhk / жилой комплекс) project pages?+
search_listings and detailed via get_listing_detail. New-development project profiles and developer-level data are not exposed. You can fork this API on Parse and revise it to add an endpoint targeting those project pages.Are listings from cities outside Almaty and Astana available?+
city parameter in search_listings returns listings across all cities on krisha.kz. You can also pass other city slugs supported by the site. Coverage depends on listing volume in each city, which varies significantly outside the two major urban centers.