autochek.africa APIautochek.africa ↗
Search used and new car listings in Kenya, get make/model data, dealer info, and loan estimates via the Autochek Africa API.
curl -X GET 'https://api.parse.bot/scraper/d3b4e66d-5b60-4016-81a7-52bd3aecb0d1/search_car_listings?make=Toyota&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Search and filter used car listings in Kenya. Returns paginated results with car details, pricing, and available filters.
| Param | Type | Description |
|---|---|---|
| make | string | Car make/brand filter (e.g. 'Toyota', 'BMW'). |
| page | integer | Page number for pagination. |
| year | integer | Manufacture year filter. |
| model | string | Car model filter (e.g. 'Corolla', 'X1'). |
| query | string | Search keyword. |
| max_price | integer | Maximum price filter in KES. |
| min_price | integer | Minimum price filter in KES. |
{
"type": "object",
"fields": {
"cars": "array of car listing objects with id, title, year, marketplacePrice, mileage, transmission, fuelType, etc.",
"filters": "object with makes, body_types, cities, selling_conditions arrays",
"pagination": "object with total, currentPage, pageSize"
},
"sample": {
"data": {
"cars": [
{
"id": "TC4UTWyOk",
"city": "Kiambu Rd",
"sold": false,
"year": 2012,
"state": "Nairobi",
"title": "BMW X1",
"mileage": 104435,
"fuelType": "petrol",
"mileageUnit": "km",
"hasFinancing": true,
"transmission": "automatic",
"marketplacePrice": 1315000
}
],
"filters": {
"makes": [
{
"id": 272,
"name": "ACTIVMO AUTO"
}
],
"cities": [
{
"id": 94,
"name": "Baringo"
}
],
"body_types": [],
"selling_conditions": " "
},
"pagination": {
"total": 1860,
"pageSize": 23,
"currentPage": 1
}
},
"status": "success"
}
}About the autochek.africa API
The Autochek Africa API gives developers structured access to Kenya's used and new car marketplace through 8 endpoints covering search, listing detail, makes, models, dealers, and financing calculations. The search_car_listings endpoint accepts filters like make, model, year, min_price, and max_price and returns paginated car objects with fields including marketplacePrice, mileage, transmission, and fuelType, along with filter metadata for makes, body types, and cities.
Listing Search and Detail
The search_car_listings endpoint accepts up to seven optional parameters — including make, model, year, min_price (KES), max_price (KES), query, and page — and returns an array of car objects alongside a filters object containing enumerated makes, body_types, cities, and selling_conditions arrays useful for building faceted search UIs. For a single listing, get_car_listing_detail takes a vehicle_id (obtainable from search results) and returns the full car object plus media (image/video URLs), features (named feature objects), inspection data with review arrays, similar_cars, and a financing object containing loanCalculator configuration ranges.
Makes, Models, and Inventory
get_car_makes_brands returns the full list of brands on the platform with id, name, and optional imageUrl, paginated. get_car_models_by_make takes a make_id and returns models available in Kenya, each with wheelType, associated make, and a popular flag. get_popular_cars returns homepage-level data in one call: a makeList of featured brands, a popular_cars result set with pagination, and a best_deals_cars array — useful for surfacing editorial picks without a search query. get_brand_new_cars returns paginated new-car inventory with the same listing shape as search results.
Loan Eligibility Estimation
get_car_loan_eligibility takes three required inputs — car_value (KES), tenure_months, and down_payment_pct (decimal 0–1) — and returns a breakdown including loan_amount, down_payment_amount, and estimated_monthly_repayment, all calculated at a fixed 21% annual interest rate. The response also includes a disclaimer string describing the estimation assumptions, making it suitable for displaying inline affordability estimates alongside listing prices.
Dealers
get_dealers returns a paginated result array of dealer objects on the platform. This is the entry point for any dealer-directory or inventory-by-dealer use case, though individual dealer filtering in listing search is not a current endpoint parameter.
- Build a used car search tool filtered by make, model, year, and KES price range using
search_car_listings. - Display a full vehicle detail page with photos, features, and inspection data from
get_car_listing_detail. - Render a brand browser with logos using
get_car_makes_brandsand drill into model inventory withget_car_models_by_make. - Show an affordability widget by calling
get_car_loan_eligibilitywith a listing's price and user-supplied down payment and tenure. - Surface homepage editorial picks — popular cars and best deals — using
get_popular_carswithout requiring a search query. - List brand new car inventory separately from used stock using the
get_brand_new_carsendpoint. - Build a dealer directory page from the paginated
dealersresult returned byget_dealers.
| 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 Autochek Africa have an official developer API?+
What does `get_car_listing_detail` return beyond basic specs?+
year, mileage, price, and transmission, the endpoint returns a media array with image/video URLs, a features array of named equipment items, an inspection object containing inspectionReviews, a financing object with loan calculator configuration, and a similar_cars array. If the listing no longer exists, the endpoint returns a stale_input indicator.Is listing data available for Autochek markets outside Kenya — such as Nigeria, Ghana, or Egypt?+
Can I filter `search_car_listings` results by dealer or city?+
city or dealer as direct filter parameters. It does return a filters.cities array in the response, which you can use to populate a city picker in a UI. You can fork this API on Parse and revise it to add a city or dealer filter parameter.Does the loan estimate use live interest rates from Autochek's financing partners?+
get_car_loan_eligibility endpoint uses a fixed 21% annual interest rate for all estimates. The response includes a disclaimer field that describes this assumption. For real financing quotes tied to a specific lender or applicant profile, the API does not currently expose that data.