# CarDekho — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and browse used and new car listings with detailed vehicle information, pricing, and specifications from CarDekho.com. View immersive 360-degree vehicle imagery to inspect cars from every angle before making a purchase decision.

**Category:** Automotive | **Website:** [cardekho.com/](https://cardekho.com/) | **Docs:** [parse.bot/marketplace/65d6430c-f72f-4f27-893f-054bf01f0c93/cardekho-com-api](https://parse.bot/marketplace/65d6430c-f72f-4f27-893f-054bf01f0c93/cardekho-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_360_view

Get 360-degree view metadata for a vehicle model including exterior and interior view items. Each item contains an image URL, title, and whether it is an interior or exterior view. Not all models have 360-degree views available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_slug` | string | Yes | Model slug identifier (e.g., 'tata-tiago', 'hyundai-creta'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_360_view \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_slug":"<string>"}'
```

### get_brand_models

List all current car models for a specific brand. Returns model names and slugs that can be used with get_model_details or get_specifications. Each call fetches one brand page (1 request).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand slug (e.g., 'tata', 'hyundai', 'maruti', 'mahindra'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_brand_models \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>"}'
```

### get_car_details

Get detailed information for a specific used car listing including price, overview specifications, and images. Requires the full detail page URL returned by search_used_cars. Each call fetches one listing's full data including registration, insurance, RTO, ownership history, and available photographs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the car detail page from search_used_cars results (e.g., from search_used_cars.cars[*].url). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_car_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_comparison_images

Extract 3 orthographic comparison image URLs (front, side, rear) from the exterior 360-degree turntable animation for a given model. Fetches the 360-view page, locates the exterior 360 player configuration, parses the frame count from the XML config, then mathematically derives: front_view at index 0 (0°), side_view at index equal to 25% of total frames (90°), and rear_view at index equal to 50% of total frames (180°). Each call makes 3 requests (page + player HTML + XML config). Not all models have 360-degree views available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `model_slug` | string | Yes | Model slug identifier combining brand and model (e.g., 'tata-tiago', 'hyundai-creta', 'tata-nexon'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_comparison_images \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_slug":"<string>"}'
```

### get_model_details

Get comprehensive details for a specific new car model including body type, ex-showroom price range, all variant names and prices, fuel types, mileage, engine specifications, safety rating (when available), key features, high-resolution images, categorized exterior images with labels (front, side, rear, etc.), and dimensional specifications (length, width, height, wheelbase, boot space). Requires brand slug and model slug. Each call fetches the model page plus the specs page (2 requests). Safety rating may be null if not published. Dimensions may be empty if not available on the specs page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand slug (e.g., 'hyundai', 'tata', 'maruti', 'mahindra'). |
| `model` | string | Yes | Model slug (e.g., 'creta', 'nexon', 'brezza'). Use the slug from the model URL on cardekho.com (the part after the brand in the URL path). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_model_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","model":"<string>"}'
```

### get_new_cars

List popular new car models, optionally filtered by brand. Returns model names, URLs, images, and prices when available. Without a brand filter, returns popular models across all brands. Price may be null for models where the manufacturer has not published pricing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Brand slug to filter models (e.g., 'tata', 'maruti', 'hyundai', 'mahindra'). Omitting returns popular models across all brands. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_new_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>"}'
```

### get_specifications

Get full technical specifications for a new car model, organized by category (Engine & Transmission, Fuel & Performance, Suspension/Steering/Brakes, Dimensions & Capacity). Extracts dimensional data (length, width, height, wheelbase, boot space) into a dedicated dimensions object for convenience. Requires brand and model slugs. Each call fetches one model's specs page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand slug (e.g., 'hyundai', 'tata', 'maruti', 'mahindra'). |
| `model` | string | Yes | Model slug (e.g., 'creta', 'nexon', 'brezza'). Use the slug from the model URL on cardekho.com. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/get_specifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","model":"<string>"}'
```

### search_used_cars

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug for filtering used car listings (e.g., 'new-delhi', 'mumbai', 'bangalore'). |
| `page` | integer | No | Page number for pagination. Must be a positive integer. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cardekho-com-api-65d6430c/search_used_cars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>"}'
```