CarDekho APIcardekho.com ↗
Access CarDekho used car listings, new car models, vehicle specs, pricing in INR, and 360-degree view data via a structured JSON API.
What is the CarDekho API?
The CarDekho API covers 4 endpoints that return structured vehicle data from CarDekho.com, including paginated used-car search results, detailed specs and images for individual listings, new car model browsing by brand, and 360-degree view metadata. The search_used_cars endpoint alone surfaces fields like sku_id, fuel_type, transmission, km, and formatted_price across Indian cities, making it straightforward to build car comparison or inventory tools without manual data collection.
curl -X GET 'https://api.parse.bot/scraper/07c72402-da37-40b8-bd63-890f88793747/search_used_cars?city=new-delhi&page=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace cardekho-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.cardekho_api import CarDekho, UsedCar, UsedCarDetail, NewCarModel, ThreeSixtyView
client = CarDekho()
# Search used cars in Mumbai
for car in client.usedcars.search(city="mumbai", limit=5):
print(car.model, car.price, car.fuel_type, car.transmission)
# Get detailed info for the first car
detail = car.details.get()
print(detail.model, detail.price)
for spec in detail.overview:
print(spec.key, spec.value)
break
# List new car models by brand
for model in client.newcarmodels.list(brand="tata", limit=5):
print(model.name, model.url, model.price)
# Get 360-degree view for a model
view = client.threesixtyviews.get(model_slug="tata-tiago")
print(view.title, view.model)
for item in view.items:
print(item.title, item.is_interior, item.image)
Search for used cars by city and page number. Returns paginated listings with basic car information including model, price, fuel type, and kilometers driven. Pagination is page-based; each page returns up to ~20 listings. The total_count field indicates the full inventory size for the queried city.
| Param | Type | Description |
|---|---|---|
| city | string | City slug for filtering used car listings (e.g., 'new-delhi', 'mumbai', 'bangalore'). |
| page | integer | Page number for pagination. Must be a positive integer. |
{
"type": "object",
"fields": {
"cars": "array of used car listing objects with id, sku_id, model, variant, year, price, formatted_price, km, fuel_type, transmission, image, url, city, owner",
"city": "string city slug used for the search",
"page": "integer current page number",
"total_count": "integer total number of cars available"
},
"sample": {
"data": {
"cars": [
{
"id": 5260337,
"km": "33,000",
"url": "https://www.cardekho.com/used-car-details/used-Bmw-5-series-530i-m-sport-cars-Gurgaon_f674833b-1aab-4e1f-bed2-e551bfb55bc3.htm?adId=27291&adType=1",
"city": "Gurgaon",
"year": 2021,
"image": "https://images10.gaadi.com/usedcar_image/5260337/original/processed_9bef44bf4fc34ad38f873f504150a053.jpg?imwidth=420",
"model": "BMW 5 Series",
"owner": "first-owner",
"price": 4300000,
"sku_id": "f674833b-1aab-4e1f-bed2-e551bfb55bc3",
"variant": "530i M Sport",
"fuel_type": "Petrol",
"transmission": "Automatic",
"formatted_price": "₹43 Lakh"
}
],
"city": "new-delhi",
"page": 1,
"total_count": 20
},
"status": "success"
}
}About the CarDekho API
Used Car Search and Listing Details
search_used_cars accepts a city slug (e.g., new-delhi, mumbai, bangalore) and a page integer, returning an array of car objects alongside a total_count field for pagination math. Each listing includes id, sku_id, model, variant, year, price, formatted_price, km, fuel_type, transmission, image, and url. The url field feeds directly into get_car_details, which returns the full detail view: a price in INR, an images array, an overview array of key-value pairs with associated icon fields, and a specifications array broken into labelled sections.
New Cars and Brand Browsing
get_new_cars returns a models array where each entry carries name, url, image, and price (when available). Omitting the optional brand parameter returns a set of popular models across brands; passing a slug like tata, maruti, hyundai, or mahindra scopes results to that manufacturer. The response also includes the url queried and the brand value used (or null if omitted), which helps with cache keying and debugging.
360-Degree View Metadata
get_360_view takes a model_slug such as tata-tiago or hyundai-creta and returns an items array. Each item includes image, text, title, and an isInterior boolean that distinguishes exterior walk-around shots from cabin views. The response also includes the resolved url, the model slug, and a title string describing the view experience. This endpoint is useful for embedding or pre-fetching visual assets in vehicle detail pages.
The CarDekho API is a managed, monitored endpoint for cardekho.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when cardekho.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official cardekho.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a used car aggregator filtered by Indian city using
search_used_carscity slugs andtotal_countfor pagination. - Display full vehicle specs and photo galleries by chaining
search_used_carsresults intoget_car_detailsvia theurlfield. - Compare fuel types and transmission options across listings for a given city and page range.
- Populate a new car catalogue filtered by brand using
get_new_carswith thebrandparameter. - Embed 360-degree exterior and interior imagery in a vehicle detail page using
get_360_viewitems filtered byisInterior. - Track used car pricing in INR across cities over time by periodically calling
search_used_carsand storing thepricefield. - Validate model slugs and retrieve canonical image URLs for new car models using
get_new_carswithout a brand filter.
| 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 | 100 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 CarDekho have an official developer API?+
What does `get_car_details` return beyond the basic listing fields?+
get_car_details returns fields not present in search_used_cars results: an images array of full-resolution URLs, an overview array of key-value objects (each with key, value, and icon), and a specifications array broken into labelled sections. Pass the url from any search_used_cars car object as the required input.Is city filtering available for new car listings?+
get_new_cars filters by brand slug, not by city. It returns model-level data — name, url, image, and price — which is brand- and model-scoped rather than regionally scoped. City-level new car availability is not currently exposed. You can fork the API on Parse and revise it to add a city-filtered new car endpoint.Does the API return user reviews or ratings for car models?+
Are there any known limitations with the `search_used_cars` pagination?+
page parameter must be a positive integer. The total_count field tells you how many total listings exist for the city, but the API does not expose a max page number directly — you need to calculate it from total_count and the number of items returned per page. Listings reflect availability at query time and can change between requests.