Search the used car catalogue of Kavak in Mexico, Brazil, Argentina, Chile, the UAE and Turkey. Every request needs a market code; unknown or unsupported codes are rejected with a 422 and are not billed, so you never get another country's cars. Filter by make, model, year, price range, km range, body type, location, transmission, fuel type, colour, drivetrain, seats, availability and keyword, and sort by relevance, price, age or km. Use the taxonomy endpoint for valid make, model, location and filter values: an unknown make, model, region or location is rejected with a 422. A model needs a valid make or must belong to some make. The region filter works in Mexico only; use location in Brazil, Argentina and Chile. The UAE has no location filter. Turkey has no taxonomy, so make is passed as given and model is not available there. Pages hold 30 cars and start at page 1. total_results is a numeric total: Kavak publishes only a display string, so Scrappa uses it when it fits the page count and derives the total from the last page otherwise (total_results_source says which). It is null when no reliable total exists; never read a count of 0 next to a non-empty results list as a total. Cars are de-duplicated by id and promo cards are removed.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
19 optional filters available.
string
Required
Market code: mx (Mexico), br (Brazil), ar (Argentina), cl (Chile), ae (United Arab Emirates) or tr (Turkey). Any other code is rejected.
US
string
Optional
Make value from the taxonomy endpoint, for example nissan.
example
string
Optional
Model value from the taxonomy endpoint, for example sentra. Not available for Turkey.
example
integer
Optional
Exact model year.
10
string
Optional
Body type value from the taxonomy endpoint, for example suv.
example
integer
Optional
Minimum price in the local currency.
10
integer
Optional
Maximum price in the local currency.
10
integer
Optional
Minimum mileage in km.
10
integer
Optional
Maximum mileage in km.
10
string
Optional
Hub value from the taxonomy endpoint. Mexico, Brazil, Argentina and Chile only.
Austin, Texas
string
Optional
City value from the taxonomy endpoint. Mexico only.
US
string
Optional
Transmission value from the taxonomy endpoint.
example
string
Optional
Fuel type value from the taxonomy endpoint.
example
string
Optional
Colour value from the taxonomy endpoint.
example
string
Optional
Drivetrain value from the taxonomy endpoint.
example
string
Optional
Seat count value from the taxonomy endpoint.
example
string
Optional
Availability value from the taxonomy endpoint.
example
string
Optional
Free text keyword.
running shoes
string
Optional
relevance, lower_price, higher_price, older, recent, lower_mileage or higher_mileage.
relevance
integer
Optional
Result page, starting at 1. Each page has up to 30 cars.
1
Errors
Handle these documented responses before retrying or showing customer-facing failures.
HTTP 422
A parameter is invalid, the market is not served, or a make, model or location value is unknown. This response is not billable.
HTTP 502
The upstream answer changed shape or answered for another market and could not be used. This response is not billable.
HTTP 503
The upstream refused the request or is unavailable. 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.