{ "openapi": "3.0.1", "info": { "title": "Krisha.kz Scraper — Kazakhstan Real Estate Listings", "description": "Krisha.kz real-estate listings for analysts, agencies and AI agents: apartments, houses, commercial, land for sale or rent in Almaty, Astana, Shymkent, any city or district of Kazakhstan.", "version": "0.1", "x-build-id": "lUJZXngyD3uMyUGFp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yadroo~krisha-kz/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yadroo-krisha-kz", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yadroo~krisha-kz/runs": { "post": { "operationId": "runs-sync-yadroo-krisha-kz", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yadroo~krisha-kz/run-sync": { "post": { "operationId": "run-sync-yadroo-krisha-kz", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "dealType": { "title": "Deal", "enum": [ "prodazha", "arenda" ], "type": "string", "description": "prodazha = for sale, arenda = for rent (monthly; use propertyType kvartiry-posutochno for daily rent).", "default": "prodazha" }, "propertyType": { "title": "Property type", "enum": [ "kvartiry", "doma-dachi", "komnaty", "kvartiry-posutochno", "kvartiry-po-chasam", "doma-dachi-posutochno", "kommercheskaya-nedvizhimost", "biznes", "prombazy", "uchastkov", "garazhi", "zarubezhnoj-nedvizhimosti" ], "type": "string", "description": "krisha.kz category slug. Rent-only: komnaty, kvartiry-posutochno, kvartiry-po-chasam, doma-dachi-posutochno. Sale-only: biznes. Legacy values doma/uchastki are auto-mapped.", "default": "kvartiry" }, "city": { "title": "City / region / district slug", "type": "string", "description": "krisha.kz location slug: a city (almaty, astana, shymkent, karaganda, aktobe, atyrau, pavlodar, taraz, ust-kamenogorsk, kostanaj, semej, uralsk, kyzylorda, aktau, petropavlovsk, kokshetau, taldykorgan, turkestan…), a region (almatinskaja-oblast, akmolinskaja-oblast…), or a district of Almaty/Astana/Shymkent (almaty-bostandykskij, almaty-medeuskij, astana-esilskij, shymkent-abajskij…). Russian names (Алматы, Бостандыкский р-н) are accepted. Empty = all Kazakhstan. Full list in README → Reference.", "default": "almaty" }, "complexId": { "title": "Residential complex id", "minimum": 1, "type": "integer", "description": "Restrict to one residential complex (ЖК). The id is the number in the complex URL on krisha.kz, e.g. https://krisha.kz/complex/almaty/1234 → 1234." }, "rooms": { "title": "Rooms", "type": "array", "description": "Room counts to include, e.g. [\"1\",\"2\",\"3\"]. \"5+\" (or \"5\") = five and more for apartments; houses accept up to \"10\". Empty = any.", "items": { "type": "string" } }, "priceFrom": { "title": "Price from, ₸", "minimum": 0, "type": "integer", "description": "Minimum price in tenge (monthly rent for arenda)." }, "priceTo": { "title": "Price to, ₸", "minimum": 0, "type": "integer", "description": "Maximum price in tenge." }, "areaFrom": { "title": "Total area from, m²", "minimum": 0, "type": "integer", "description": "Minimum total area (for commercial property → premises area)." }, "areaTo": { "title": "Total area to, m²", "minimum": 0, "type": "integer", "description": "Maximum total area." }, "kitchenAreaFrom": { "title": "Kitchen area from, m²", "minimum": 0, "type": "integer", "description": "Apartments only." }, "kitchenAreaTo": { "title": "Kitchen area to, m²", "minimum": 0, "type": "integer", "description": "Apartments only." }, "floorFrom": { "title": "Floor from", "minimum": 0, "type": "integer", "description": "Apartments only." }, "floorTo": { "title": "Floor to", "minimum": 0, "type": "integer", "description": "Apartments only." }, "notFirstFloor": { "title": "Not first floor", "type": "boolean", "description": "Exclude ground-floor apartments.", "default": false }, "notLastFloor": { "title": "Not last floor", "type": "boolean", "description": "Exclude top-floor apartments.", "default": false }, "buildingFloorsFrom": { "title": "Floors in building from", "minimum": 0, "type": "integer", "description": "Minimum number of floors in the building." }, "buildingFloorsTo": { "title": "Floors in building to", "minimum": 0, "type": "integer", "description": "Maximum number of floors in the building." }, "yearFrom": { "title": "Year built from", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Building constructed in this year or later." }, "yearTo": { "title": "Year built to", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Building constructed in this year or earlier." }, "buildingType": { "title": "Building type (apartments)", "enum": [ "brick", "panel", "monolith", "other" ], "type": "string", "description": "brick = кирпичный, panel = панельный, monolith = монолитный, other = иной. Leave unset for any." }, "bathroom": { "title": "Bathroom (apartments)", "enum": [ "separate", "combined", "twoOrMore", "none" ], "type": "string", "description": "Toilet/bathroom layout. Leave unset for any." }, "ownerOnly": { "title": "Owners only (no agents)", "type": "boolean", "description": "Only listings posted by the property owner (`das[who]=1`). Great for lead generation.", "default": false }, "fromAgentsOnly": { "title": "Krisha Agents only", "type": "boolean", "description": "Only listings from verified Krisha Agents (`das[_sys.fromAgent]=1`).", "default": false }, "hasPhoto": { "title": "With photos only", "type": "boolean", "description": "Only listings with photos.", "default": false }, "newBuildingOnly": { "title": "New buildings only", "type": "boolean", "description": "Primary market (новостройки) only. Leave off for secondary + primary.", "default": false }, "mortgageAvailable": { "title": "Mortgage possible", "type": "boolean", "description": "Seller states the apartment qualifies for a mortgage.", "default": false }, "notDormitory": { "title": "Exclude former dormitories", "type": "boolean", "description": "Exclude apartments in former dormitories (общежитие).", "default": false }, "exchangePossible": { "title": "Exchange possible", "type": "boolean", "description": "Seller accepts exchange (обмен).", "default": false }, "furniture": { "title": "Furniture (rent)", "enum": [ "full", "partial", "none" ], "type": "string", "description": "Rent (arenda) only. Leave unset for any." }, "petsAllowed": { "title": "Pets allowed (rent)", "type": "boolean", "description": "Rent only: landlord accepts pets.", "default": false }, "kidsAllowed": { "title": "Kids allowed (rent)", "type": "boolean", "description": "Rent only: landlord accepts families with kids.", "default": false }, "houseType": { "title": "House type (doma-dachi)", "enum": [ "detached", "partOfHouse", "dacha" ], "type": "string", "description": "Leave unset for any." }, "wallMaterial": { "title": "Wall material (doma-dachi)", "enum": [ "brick", "monolith", "wood", "adobe", "gasSilicate", "aeratedConcrete", "cinderBlock", "foamBlock", "thermoBlock", "frameReed", "framePanel", "sip", "concretePanel", "shellRock", "finBlock" ], "type": "string", "description": "Leave unset for any." }, "renovation": { "title": "Condition (doma-dachi)", "enum": [ "fresh", "decent", "needsRepair", "roughFinish", "demolition", "unfinished" ], "type": "string", "description": "Leave unset for any." }, "heating": { "title": "Heating (doma-dachi)", "enum": [ "central", "gas", "solidFuel", "liquidFuel", "electric", "mixed", "none" ], "type": "string", "description": "Leave unset for any." }, "sewage": { "title": "Sewage (doma-dachi)", "enum": [ "central", "canConnect", "septic", "none" ], "type": "string", "description": "Leave unset for any." }, "landAreaFrom": { "title": "Land area from, sotka", "minimum": 0, "type": "integer", "description": "Houses, land plots, garages. 1 sotka = 100 m²." }, "landAreaTo": { "title": "Land area to, sotka", "minimum": 0, "type": "integer", "description": "Maximum land area in sotka (100 m²)." }, "commercialUse": { "title": "Commercial use (kommercheskaya-nedvizhimost)", "enum": [ "any", "office", "retail", "warehouse", "auto", "catering", "beauty", "agriculture", "hospitality", "medical", "education", "entertainment" ], "type": "string", "description": "Leave unset for any." }, "commercialLocation": { "title": "Commercial location", "enum": [ "businessCenter", "residential", "mall", "market", "standalone" ], "type": "string", "description": "Leave unset for any." }, "withTenants": { "title": "With tenants (commercial)", "type": "boolean", "description": "Premises sold/rented with existing tenants (income-producing).", "default": false }, "asBusiness": { "title": "Sold as business (commercial)", "type": "boolean", "description": "Premises offered together with the business.", "default": false }, "extraParams": { "title": "Extra raw das[...] parameters", "type": "object", "description": "Escape hatch for any krisha.kz filter not listed above, e.g. {\"das[flat.phone]\": \"1\", \"das[garage.object_type][1]\": \"1\"}. Keys must start with das[. Copy them from the krisha.kz URL after applying a filter in the browser." }, "sort": { "title": "Sort", "enum": [ "newest", "cheapest", "expensive" ], "type": "string", "description": "Order of results as on krisha.kz. Paid 'hot' listings are always shown first on every page.", "default": "newest" }, "sinceHours": { "title": "Only listings from the last N hours", "minimum": 1, "maximum": 8760, "type": "integer", "description": "Keep only listings published within the last N hours (krisha shows publish dates with day precision, so 24 = today+yesterday boundary, 48 = last two days…). With sort=newest pagination stops as soon as a page is entirely older — ideal for hourly monitoring. Empty = no time filter." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many listings (pagination is automatic, ~20 listings per page).", "default": 40 }, "maxPages": { "title": "Max pages", "minimum": 1, "maximum": 300, "type": "integer", "description": "Hard cap on search pages fetched (safety limit).", "default": 50 }, "detail": { "title": "Open each listing page (full details)", "type": "boolean", "description": "Fetch every listing page to add: full description, all parameters (balcony, parking, security, ceiling…), GPS coordinates, structured address, all photos, owner name & type, complex id, verified-estate flag, exact publish date. One extra request per listing (slower, ~0.6 s each).", "default": false }, "includeViews": { "title": "Include view counts", "type": "boolean", "description": "Attach the site's view counter to each listing (one cheap batch request per 25 listings). Useful to rank demand.", "default": true }, "dedupe": { "title": "Deduplicate by listing id", "type": "boolean", "description": "Drop repeated ids (paid listings are repeated in the 'hot' block on every page).", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }