Return the live filter widgets of a city with the number of cars behind every option: budget, make and model, seller type, year, odometer, fuel, body type, transmission, colour, features, seats, owners, RTO, hubs and more. Each option carries the key and value that you send to the search endpoint. The widget list is read live and is never hard-coded, so new filters appear without a release. Pass active filters (make, fuel and the others from the search endpoint) to get counts for that selection. Use view=presets for the curated chips of a city: popular cars, brands, fuel types, body types and budgets with ready-made filters.
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.
4 optional filters available.
integer
Optional
City id from the cities endpoint.
1234567890
string
Optional
facets (default) or presets.
example
string
Optional
Active make filter, same values as the search endpoint (facets view).
example
string
Optional
Active fuel filter, same values as the search endpoint (facets view).
example
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.