# Cars24 Search

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.

- **Documentation:** [https://scrappa.co/docs/cars24-api/cars24_search](https://scrappa.co/docs/cars24-api/cars24_search)
- **API group:** Cars24 API
- **Endpoint:** `GET https://scrappa.co/api/cars24/v1/search`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `city_id` | integer | No | City id from the cities endpoint. Default 1 (Delhi NCR). |
| `make` | string | No | Make value or comma list from the makes endpoint, for example maruti or maruti,hyundai. |
| `model` | string | No | Model value or comma list from the makes endpoint, for example swift. |
| `year_min` | integer | No | Minimum model year. |
| `year_max` | integer | No | Maximum model year. |
| `price_min` | integer | No | Minimum price in rupees. |
| `price_max` | integer | No | Maximum price in rupees. |
| `km_min` | integer | No | Minimum mileage in km. |
| `km_max` | integer | No | Maximum mileage in km. |
| `fuel` | string | No | Fuel value or comma list, for example petrol,diesel. Values come from the filters endpoint. |
| `transmission` | string | No | manual or automatic. |
| `body_type` | string | No | Body type value or comma list, for example suv,sedan. |
| `color` | string | No | Colour value or comma list from the filters endpoint. |
| `owners` | string | No | Number of previous owners as a comma list, for example 1,2. |
| `seats` | string | No | Seat count as a comma list, for example 5,7. |
| `business_vertical` | string | No | gs for Cars24 Assured, c2c for private sellers. Default both. |
| `hub` | string | No | Hub filter value from the filters endpoint, comma list. |
| `sort` | string | No | 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). |
| `lat` | number | No | Latitude. Needed for sort dist. |
| `lon` | number | No | Longitude. Needed for sort dist. |
| `size` | integer | No | Cars per page from 1 to 30. |
| `page` | integer | No | Page number, starting at 1. A page above 1 needs the cursor. |
| `cursor` | string | No | Opaque cursor from data.next_cursor of the previous response. Needed for a page above 1. |
| `nearby` | boolean | No | true groups the cars of the cities around the city. Page 1 and the default sort only. |

## Errors

| Status | Error | Description |
| --- | --- | --- |
|  | A parameter is invalid. This response is not billable. |  |
|  | 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. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)