kolesa.kz APIkolesa.kz ↗
Access car listings, spare parts, makes, models, and city data from Kolesa.kz via 7 structured endpoints. Filter by region, body type, drive, and more.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/a9b1ccd7-3ece-419a-a870-f59a9c013307/get_makes' \ -H 'X-API-Key: $PARSE_API_KEY'
Get list of all car makes/brands with their IDs, slugs, popularity counts, and icons. No parameters required.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of car make objects with id, label, urlAlias, icon, synonyms, isPopular, and popular count"
},
"sample": {
"data": {
"items": [
{
"id": 176,
"icon": "https://kolesa.kz/static/frontend/images/app/v2/mark-logos/176_toyota.png",
"label": "Toyota",
"popular": 39126,
"synonyms": [
"Тоиота",
"Тайота",
"Toyota",
"Тойота"
],
"urlAlias": "toyota",
"isPopular": true,
"brandCountryId": 12
}
]
},
"status": "success"
}
}About the kolesa.kz API
The Kolesa.kz API exposes 7 endpoints covering Kazakhstan's largest automotive marketplace — car listings, spare parts, commercial vehicles, motorcycles, and water transport. The search_cars endpoint accepts filters for make, model, body type, drive, color, customs status, and region, returning paginated summaries with price, city, date, and thumbnail. Companion endpoints like get_makes, get_models, and get_cities provide the reference IDs and slugs those filters require.
Reference Data: Makes, Models, and Cities
Before running searches, use get_makes to retrieve the full list of car brands available on Kolesa.kz. Each object in the items array includes an id, label, urlAlias, icon, synonyms, and isPopular flag. Pass the numeric id to get_models to get the model list for that brand — each model carries its own id, urlAlias, bodyGroup, and popularity count. Use get_cities to get Kazakhstan oblasts and international region slugs needed for the region filter across all search endpoints.
Car Listing Search and Detail
search_cars accepts optional parameters for mark, model, body, drive, color, customs, region, and page. Results are paginated; the response includes total_pages and current_page alongside the items array. Each item contains id, title, url, price, city, date, thumbnail, and description_short. To get the full record for any listing, pass its id to get_car_listing, which returns the complete params object (generation, engine, transmission, drive, steering wheel, color, customs status), a photos array, seller info, stats (views and publish date), and the seller's description text.
Spare Parts and Other Vehicle Categories
search_spare_parts searches the spare parts section and accepts a free-text query parameter alongside mark, model, and region filters. Because the site operates in Russian and Kazakh, search queries should be in one of those languages — for example, фара for headlight or тормозные колодки for brake pads. search_other_categories covers three additional segments via the required category parameter: commercial (trucks and vans), motorcycles, and water (boats and watercraft). Both endpoints return the same paginated summary shape as search_cars.
- Aggregate current used car prices in Kazakhstan by make, model, and region using
search_carsprice fields - Build a cross-border vehicle sourcing tool filtering Kolesa.kz listings by customs cleared status
- Track spare parts availability and pricing for specific makes and models in a given city
- Populate a vehicle lookup UI with make and model hierarchies from
get_makesandget_models - Monitor commercial vehicle inventory in Almaty or other oblasts via
search_other_categorieswith category='commercial' - Pull full vehicle specs and photo galleries for a car detail page using
get_car_listingparams and photos fields - Compare seller listing volumes by region using paginated results from
search_carswith differentregionslugs
| 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 Kolesa.kz have an official public developer API?+
How do I get the correct slug values for make, model, and region filters in search_cars?+
get_makes to get the urlAlias for each brand (e.g. 'toyota', 'bmw'), then pass the numeric id from that response to get_models to get model slugs like 'camry' or 'land-cruiser-prado'. Region slugs come from get_cities, which returns an alias field for each oblast and city (e.g. 'almaty', 'region-almatinskaya-oblast'). The model filter in search_cars requires mark to also be set.What vehicle parameters does get_car_listing return, and what is not included?+
params object in get_car_listing includes city, generation, body type, engine, transmission, drive type, steering wheel side, color, and customs status. VIN numbers, service history records, and inspection reports are not currently exposed by the API. You can fork the API on Parse and revise it to add an endpoint targeting those fields if they become accessible on a listing page.Does the spare parts search support English-language queries?+
search_spare_parts endpoint's query parameter is designed for Russian or Kazakh text, matching the language of the Kolesa.kz spare parts section. English queries are likely to return few or no results. The API currently covers Russian and Kazakh text matching. You can fork it on Parse and revise to add transliteration or translation preprocessing if your application requires English input.Can I retrieve seller contact information such as phone numbers from listings?+
seller object in get_car_listing returns the seller's display name and city. Phone numbers and direct contact details are not currently returned by the API. You can fork it on Parse and revise to add an endpoint that retrieves contact fields if they are available on the listing page without authentication.