# CarDekho API (`truefetch/cardekho-api`) Actor

CarDekho API for public India vehicle listings by keyword. Return 37 normalized fields for INR prices, specifications, images, seller context, locations, and source URLs with CarDekho-only routing.

- **URL**: https://apify.com/truefetch/cardekho-api.md
- **Developed by:** [TrueFetch](https://apify.com/truefetch) (community)
- **Categories:** E-commerce, Lead generation, Integrations
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $5.03 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

**CarDekho API is a cardekho api that searches public CarDekho inventory in India and returns 37 normalized vehicle fields with INR prices, images, and source URLs.**

- **CarDekho is selected automatically and cannot be replaced through input.**
- **India is the runtime market for this edition.**
- **The prefilled Hyundai Creta search has a nine-result workload ceiling.**
- **Rows retain source URLs while unsupported fields remain empty.**

[**Run a one-result test**](https://apify.com/truefetch/cardekho-api) · [**View API**](https://apify.com/truefetch/cardekho-api/api)

Set `max_results` to `1` for the smallest useful test. Billing includes Actor Start and only the result rows actually written to the default Dataset.

### What does CarDekho API do?

CarDekho API turns a public vehicle search into structured Dataset rows for India through public CarDekho vehicle listings. It accepts the current schema inputs, follows the edition's routing rules, and writes source-linked records that can move directly into JSON, CSV, Excel, a database, or another Apify workflow.

The official CarDekho used-car search presents inventory with price, model, fuel, transmission, location, and seller context when sellers provide it. [See the official CarDekho used-car search](https://www.cardekho.com/usedcars).

The Actor is a collection and normalization tool, not a vehicle-history report, appraisal, inspection, financing decision, or guarantee of current stock. Important commercial facts should be checked on `source_url`, because listings and catalog pages can change after collection.

### How do I run CarDekho API?

Run CarDekho API by starting with its prefilled scenario, reviewing one source-linked row, and increasing scope only after the data matches the intended workflow.

1. Open the [CarDekho API input page](https://apify.com/truefetch/cardekho-api) and review every required value.
2. Set `country` to `India`, `keyword` to `Hyundai Creta`, and `max_results` to `9`; for the smallest risk test, temporarily use `max_results: 1`.
3. Start the Actor and wait for the default Dataset.
4. Open `source_url` from a returned row before expanding the result ceiling or scheduling repeats.

```json
{
  "max_results": 9,
  "country": "India",
  "keyword": "Hyundai Creta"
}
```

The result limit is a ceiling rather than a promise. Live inventory, source access, unique listing URLs, and the fields available on each page determine how many records can be published.

### What data does CarDekho API return?

CarDekho API returns one object per source record using exactly 37 public fields. Values unavailable from the source remain empty; the Actor does not derive a VIN, seller, mileage, location, or vehicle specification from the keyword.

| Field group | Public fields | Meaning |
| --- | --- | --- |
| Identity and price | `main_image`, `title`, `price`, `currency`, `year`, `make`, `model`, `trim` | Primary media, listing title, asking price, and vehicle identity. |
| Mileage and geography | `mileage`, `mileage_unit`, `location`, `latitude`, `longitude`, `country` | Odometer values and source-published place data. |
| Source and seller | `platform`, `source_url`, `seller`, `seller_type` | Marketplace attribution, original listing link, and public seller context. |
| Vehicle attributes | `condition`, `body_type`, `seats`, `fuel`, `transmission`, `engine`, `drive_type`, `exterior_color`, `interior_color`, `vin` | Source-published condition, dimensions, powertrain, colors, and identifiers. |
| Lifecycle and content | `listing_id`, `posted_at`, `updated_at`, `description`, `images`, `price_text`, `official_url`, `processor`, `processed_at` | Source identity, dates, descriptive content, additional links, and processing attribution. |

This abbreviated illustrative item uses the same scenario; a real row follows the full 37-field schema.

```json
{
  "main_image": "https://example.com/cardekho/hyundai-creta.jpg",
  "title": "2021 Hyundai Creta SX",
  "price": 1425000,
  "currency": "INR",
  "year": 2021,
  "make": "Hyundai",
  "model": "Creta",
  "mileage": 23000,
  "fuel": "Petrol",
  "transmission": "Automatic",
  "country": "India",
  "platform": "CarDekho",
  "source_url": "https://www.cardekho.com/used-car-details/example",
  "processed_at": "2026-08-10T08:03:22Z"
}
```

Apify Datasets support JSON, JSONL, CSV, Excel, XML, HTML, and RSS retrieval through the [Dataset items API](https://docs.apify.com/api/v2/dataset-items-get). Keep `source_url` and `processed_at` when exporting so later reviews retain both source provenance and collection time.

### What inputs can I configure?

CarDekho API exposes only inputs supported by its current runtime route, with required fields marked explicitly and no invented non-empty fallback for optional filters.

| Input | Type | Required | Behavior | Example |
| --- | --- | --- | --- | --- |
| `max_results` | integer | Yes | Maximum CarDekho records returned by the run. | `9` |
| `country` | string | Yes | Required market input; this edition accepts India. | `"India"` |
| `keyword` | string | Yes | Required make, model, or vehicle phrase preserved as submitted. | `"Hyundai Creta"` |

The complete effective test input is formed from schema defaults overridden by prefills. API callers can replace those values, but must still send each required field with a schema-valid value.

### What platforms and markets does CarDekho API cover?

CarDekho API covers India through public CarDekho vehicle listings; coverage follows the source relationships registered for this edition rather than assumptions based on the Actor's title.

The edition covers CarDekho in India and does not silently fall back to another India marketplace.

City and seller details can appear in output when the source listing exposes them, but the public input does not apply a native location filter.

Source inventory, language, seller-entered fields, and page availability change independently. The Dataset describes what was available when the run processed each record.

### Why use CarDekho API?

CarDekho API is useful when a repeatable API and Dataset contract matters more than manually copying vehicle cards or maintaining a source-specific export parser.

| Capability | Practical benefit |
| --- | --- |
| CarDekho-only routing | Keep source attribution stable across repeated India searches. |
| INR price fields | Build numeric asking-price samples without discarding formatted source text. |
| Vehicle specification columns | Analyze year, mileage, fuel, transmission, and body type when present. |
| Images and source URLs | Create review queues that lead back to the public advertisement. |
| API and MCP delivery | Reuse the same three-input scenario in code or an agent workflow. |

The normalized contract is convenient for pipelines, but it intentionally omits native fields that cannot be mapped consistently. This is why null handling and source-link retention are part of a reliable downstream design rather than cleanup tasks.

### Who is CarDekho API for?

CarDekho API is designed for developers, India automotive researchers, pricing analysts, dealer intelligence teams, and data engineers working with public CarDekho records. It works for teams that need a reproducible input, structured output, and a review path back to each public source record.

Hyundai Creta inventory sampling, model-level price distributions, fuel and transmission comparisons, used-car availability snapshots, and human review queues fit this focused source. Reusing the nine-result scenario keeps longitudinal exports comparable.

Do not use it as a vehicle inspection, ownership report, private contact database, financing decision, or guarantee that every CarDekho listing is present. Vehicle purchases, lending, insurance, safety, and regulatory decisions require independent checks beyond a scraped public listing.

### How can I use CarDekho API through the API or MCP?

CarDekho API has the public Actor ID `rNLtqZZcBAumSbeK2`; the stable name form `truefetch/cardekho-api` is also available for human-readable integrations.

```text
rNLtqZZcBAumSbeK2
```

This synchronous HTTP request uses the same scenario and returns Dataset items directly:

```bash
curl -L "https://api.apify.com/v2/acts/rNLtqZZcBAumSbeK2/run-sync-get-dataset-items?maxItems=1" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <APIFY_TOKEN>" \
  -d '{"max_results":9,"country":"India","keyword":"Hyundai Creta"}'
```

Apify also provides a hosted Streamable HTTP MCP server:

```json
{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs"
    }
  }
}
```

After authentication, ask the MCP client to inspect Actor ID `rNLtqZZcBAumSbeK2`, run the same input, and return the default Dataset rows. The [CarDekho API API page](https://apify.com/truefetch/cardekho-api/api) provides generated SDK and OpenAPI examples, while the [Apify MCP guide](https://docs.apify.com/integrations/mcp) documents current client setup.

### How much does CarDekho API cost?

CarDekho API costs $0.00670 per result on the FREE tier plus $0.01000 per Actor Start event; memory determines the number of Start events at one per GB, minimum one.

| Event or tier | Price | Billing unit |
| --- | ---: | --- |
| Actor Start | $0.01000 | Per GB of Actor memory, minimum one event. |
| Result — FREE | $0.00670 | One item written to the default Dataset. |
| Result — BRONZE | $0.00603 | One Dataset item. |
| Result — SILVER | $0.00536 | One Dataset item. |
| Result — GOLD | $0.00503 | One Dataset item. |
| Result — PLATINUM | $0.00503 | One Dataset item. |
| Result — DIAMOND | $0.00503 | One Dataset item. |

Smallest-test calculation, assuming the minimum one Start event: $0.01000 Actor Start + 1 result × $0.00670 = **$0.01670**. A run that writes no row can still incur Actor Start. Check the [live pricing page](https://apify.com/truefetch/cardekho-api/pricing) before budgeting a larger workflow because prices can change.

### How does CarDekho API compare with alternatives?

CarDekho API is the best fit when its documented source and normalized contract match the job; broader, manual, or contractual approaches solve different problems.

| Option | Best fit | Trade-off |
| --- | --- | --- |
| CarDekho API | Focused India research with stable normalized columns. | It covers CarDekho rather than every India marketplace. |
| Car Listings API | Broader country-aware and multi-source vehicle collection. | More routing choices than a CarDekho-only workflow needs. |
| Manual CarDekho search | One-time review with every source-page detail visible. | Poor fit for recurring export and comparison. |
| A licensed native feed | Contractual completeness and source-specific commercial terms. | Different access, pricing, and integration obligations. |

No option eliminates the need to verify a mutable vehicle advertisement before a purchase or other high-impact decision.

### What are the limits and troubleshooting steps?

CarDekho API depends on public source responses, so troubleshooting begins with the exact input, the current source page, and whether the default Dataset contains a row.

| Symptom or limit | Explanation and next step |
| --- | --- |
| A different platform appears | Treat it as an attribution defect and report the run ID plus source URL. |
| Another country is rejected | India is the accepted market for the CarDekho edition. |
| No location input is shown | The current CarDekho request path does not apply a supported user location. |
| The Dataset is sparse | Search results expose a subset of the shared schema; keep nullable fields nullable. |
| The row count is below nine | The ceiling cannot create live inventory or duplicate unique source links. |

For a reproducible report, use `max_results: 1`, include the run ID and exact input, and add one public source URL when available. Never include an Apify token, private seller data, or credentials in an [Issue](https://apify.com/truefetch/cardekho-api/issues).

### Frequently asked questions

#### Which inputs are required?

`max_results`, `country`, and `keyword` are required.

#### Is this a cardekho car listings api?

Yes. It turns public CarDekho search results into normalized Apify Dataset rows.

#### Can I use it as an india used car listings api?

Yes for CarDekho-sourced public records. It does not represent every India marketplace or government record.

#### Can I filter by city?

Not through the current input. Location can appear in output when CarDekho publishes it.

#### Is there a free India car API?

Testing may fit within your Apify plan allowances, while actual execution follows the shown run-start and per-result charges.

#### Can I schedule runs to monitor Hyundai Creta listings over time?

Yes. Save the same keyword and result ceiling, then compare price, mileage, listing ID, and source URL between runs.

#### Why are VIN or seller fields empty?

Those fields remain empty when the search result does not expose a reliable value.

### Related TrueFetch Actors

Three TrueFetch Actors cover the closest adjacent vehicle markets without duplicating this Actor's exact source scope.

- [Car Listings API](https://apify.com/truefetch/car-listings-api) — Use it for multi-source or multi-country work.
- [Autohome API](https://apify.com/truefetch/autohome-api) — Use it for Mainland China vehicle catalog records.
- [Webmotors API](https://apify.com/truefetch/webmotors-api) — Use it for Brazil vehicle inventory.

### Support

Use the [Store page](https://apify.com/truefetch/cardekho-api) for the input, the [API page](https://apify.com/truefetch/cardekho-api/api) for generated integration examples, and [Issues](https://apify.com/truefetch/cardekho-api/issues) for a reproducible bug. Discuss vehicle-data workflows in the [TrueFetch community on Telegram](https://t.me/TrueFetch).

[**Run a focused CarDekho API test**](https://apify.com/truefetch/cardekho-api) · [**Open the CarDekho API API**](https://apify.com/truefetch/cardekho-api/api)

**Last Updated:** August 10, 2026

# Actor input Schema

## `max_results` (type: `integer`):

Maximum public CarDekho vehicle records returned by this India run.

## `country` (type: `string`):

Required market input; this source-locked CarDekho API accepts India.

## `keyword` (type: `string`):

Required CarDekho make, model, or vehicle phrase sent without translation or replacement.

## `platforms` (type: `array`):

Source selector fixed to CarDekho for this edition.

## `location` (type: `string`):

Optional contract field; CarDekho rejects locations it cannot send through a native source request.

## Actor input object example

```json
{
  "max_results": 4,
  "country": "India",
  "keyword": "Hyundai Creta",
  "platforms": [
    "CarDekho"
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

Open the overview table for normalized vehicle listings from the selected supported platforms.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "max_results": 4,
    "country": "India",
    "keyword": "Hyundai Creta",
    "platforms": [
        "CarDekho"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("truefetch/cardekho-api").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "max_results": 4,
    "country": "India",
    "keyword": "Hyundai Creta",
    "platforms": ["CarDekho"],
}

# Run the Actor and wait for it to finish
run = client.actor("truefetch/cardekho-api").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "max_results": 4,
  "country": "India",
  "keyword": "Hyundai Creta",
  "platforms": [
    "CarDekho"
  ]
}' |
apify call truefetch/cardekho-api --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,truefetch/cardekho-api"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/rNLtqZZcBAumSbeK2/builds/UYqZHjUDI6jvt5NLt/openapi.json