Search the used car catalogue of Cars24 in India. Choose a city and filter by make, model, year, price, km, fuel, transmission, body type, colour, owners, seats, seller type and hub. Sort by best match, newest, price, km, age or distance. Each page holds up to 30 cars. Follow data.next_cursor to read the next page: a page above 1 needs the cursor of the previous response. Every filter is checked against the upstream answer and every car is checked against your filters, so a car that breaks a filter is never returned. If the upstream drops a filter, ignores the cursor or returns rows out of sort order, the request fails with UPSTREAM_FILTER_MISMATCH (HTTP 503) and is not billed. A city search also lists cars of nearby cities: each car reports its real city and data.cities lists the cities that contributed. When both seller types are returned, Cars24 Assured cars come first and private sellers follow, each group in the requested sort order. Only available cars are returned, so a page can hold fewer cars than size when reserved cars are dropped. Without a seller type, cars from Cars24 Assured and private sellers are both returned.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
This endpoint has no required query parameters.
24 optional filters available.
integer
Optional
City id from the cities endpoint. Default 1 (Delhi NCR).
1234567890
string
Optional
Make value or comma list from the makes endpoint, for example maruti or maruti,hyundai.
example
string
Optional
Model value or comma list from the makes endpoint, for example swift.
example
integer
Optional
Minimum model year.
10
integer
Optional
Maximum model year.
10
integer
Optional
Minimum price in rupees.
10
integer
Optional
Maximum price in rupees.
10
integer
Optional
Minimum mileage in km.
10
integer
Optional
Maximum mileage in km.
10
string
Optional
Fuel value or comma list, for example petrol,diesel. Values come from the filters endpoint.
example
string
Optional
manual or automatic.
example
string
Optional
Body type value or comma list, for example suv,sedan.
example
string
Optional
Colour value or comma list from the filters endpoint.
example
string
Optional
Number of previous owners as a comma list, for example 1,2.
example
string
Optional
Seat count as a comma list, for example 5,7.
example
string
Optional
gs for Cars24 Assured, c2c for private sellers. Default both.
example
string
Optional
Hub filter value from the filters endpoint, comma list.
example
string
Optional
bestmatch, lhl (newest listed), plh (price low to high), phl (price high to low), olh (km low to high), ohl (km high to low), alh (newest year first), ahl (oldest year first) or dist (nearest, needs lat and lon).
relevance
number
Optional
Latitude. Needed for sort dist.
10
number
Optional
Longitude. Needed for sort dist.
10
integer
Optional
Cars per page from 1 to 30.
10
integer
Optional
Page number, starting at 1. A page above 1 needs the cursor.
1
string
Optional
Opaque cursor from data.next_cursor of the previous response. Needed for a page above 1.
0
boolean
Optional
true groups the cars of the cities around the city. Page 1 and the default sort only.
true
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A parameter is invalid. This response is not billable.
HTTP 503
The upstream refused the request, is unavailable, changed its answer shape or did not honour a filter, the sort or the cursor (error.code PARSER_DRIFT, UPSTREAM_FILTER_MISMATCH, UPSTREAM_BLOCKED or UPSTREAM_UNAVAILABLE). No data is returned. This response is not billable.
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.