# Cars24 Used Cars Scraper (`maximedupre/cars24`) Actor

Collect public Cars24 India used-car listings for price checks and inventory research. Get prices, years, kilometers driven, car details, and source links in a dataset.

- **URL**: https://apify.com/maximedupre/cars24.md
- **Developed by:** [Maxime Dupré](https://apify.com/maximedupre) (community)
- **Categories:** E-commerce, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 car listings

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### 🚗 Cars24 used-car data for price and inventory research

Car buyers, dealers, and market researchers can collect public Cars24 India used cars in a dataset. Get asking prices, years, kilometers driven, vehicle details, and source links to compare listings and build a car shortlist.

- Collect **[Cars24 India Used Cars](https://apify.com/maximedupre/cars24/examples/cars24-india-used-cars)** for a view of available listings.
- Find **[Used Cars Under 5 Lakh](https://apify.com/maximedupre/cars24/examples/used-cars-under-5-lakh)** within your price range.
- Compare **[Used Maruti Suzuki Swift](https://apify.com/maximedupre/cars24/examples/used-maruti-suzuki-swift)** listings by price and kilometers driven.
- Find **[Used Cars 2022 Onwards](https://apify.com/maximedupre/cars24/examples/used-cars-2022-onwards)** for a newer-car shortlist.
- Search for **[Low Mileage Used Cars](https://apify.com/maximedupre/cars24/examples/low-mileage-used-cars)** with a limit on kilometers driven.

#### 📋 Prices, vehicle details, and public source links

Each saved row represents one public Cars24 India used-car listing. It includes the listing ID, URL, make, model, asking price, currency, year, and kilometers driven. Other details, such as photos, owner count, location, inspection findings, and financing terms, depend on what Cars24 publishes.

The Actor saves the first eligible match for each source listing as it is found. If the same listing appears through another search URL, it ignores that later match. A saved row does not combine data from later matches.

#### ▶️ Run a Cars24 search

1. Choose **Search URLs** or **Vehicle filters** in the input form.
2. For Search URLs, add one or more Cars24 India search links. For Vehicle filters, enter a city, make, model, or price, year, and distance limits.
3. Set **Maximum listings** to cap the run. Leave it empty to return all available results until the source is exhausted.
4. Start the run and open the dataset to review the saved cars.

#### ⚙️ Input

Only fields for the chosen search method apply. `searchMethod` is required. Search URLs keep supported filters in the submitted links, including body type, fuel type, and transmission. Vehicle filters use the separate fields below.

**Input fields**

| Field | Type | What it does |
|---|---|---|
| `searchMethod` | string | Chooses `searchUrls` or `vehicleFilters`. |
| `searchUrls` | array of objects | Adds one or more Cars24 India search URLs for Search URLs mode. |
| `searchUrls[].url` | string | Gives the Cars24 search link to read. |
| `city` | string | Sets a supported Indian city for Vehicle filters. Leave blank for the national Indian catalog. |
| `make` | string | Sets a make, such as Maruti Suzuki. Leave blank for all makes. |
| `model` | string | Sets a model, such as Swift, within the make entered above. Leave blank for all models of that make. |
| `minPrice` | integer | Sets the lowest asking price in INR. Leave blank for no lower price limit. |
| `maxPrice` | integer | Sets the highest asking price in INR, at least as high as `minPrice`. Leave blank for no upper price limit. |
| `minYear` | integer | Sets the earliest model year. Leave blank for no lower year limit. |
| `maxYear` | integer | Sets the latest model year, at least as late as `minYear`. Leave blank for no upper year limit. |
| `maxKilometers` | integer | Sets the highest kilometers driven. Leave blank for no distance limit. |
| `maxItems` | integer | Caps matching listings across the run in either mode. Leave empty to return all available results until the source is exhausted. |

**Example input**

This input is copied from the successful default-input run on the current beta build.

```json
{
  "searchMethod": "searchUrls",
  "searchUrls": [
    {
      "url": "https://www.cars24.com/buy-used-cars/"
    }
  ],
  "maxItems": 10
}
```

#### 🧾 Output

The run output links to the dataset. Saved rows contain the required listing fields below. Optional fields may be absent when the source does not provide them.

**Run output**

| Field | Type | What it does |
|---|---|---|
| `listings` | string | Links to the collected used-car listings in the dataset overview. |

**Listing fields**

| Field | Type | What it does |
|---|---|---|
| `listingId` | string | Cars24 ID for the listing. |
| `url` | string | Public Cars24 page for the car. |
| `make` | string | Published vehicle make. |
| `model` | string | Published vehicle model. |
| `price` | number | Asking price in the stated currency. |
| `currency` | string | Published price currency, such as INR. |
| `year` | integer | Published model year. |
| `kilometers` | number | Published kilometers driven. |
| `trim` | string | Vehicle trim or variant. |
| `bodyType` | string | Vehicle body type. |
| `fuelType` | string | Fuel type. |
| `transmission` | string | Transmission type. |
| `color` | string | Vehicle color. |
| `seats` | integer | Number of seats. |
| `ownerCount` | integer | Number of prior owners. |
| `sellerType` | string | Seller or stock class stated by Cars24. |
| `availability` | string | Availability stated by the listing when read. |
| `originalPrice` | number | Original or pre-discount price in the stated currency. |
| `onRoadPrice` | number | Published on-road price in the stated currency. |
| `promotion` | string | Published offer terms. |
| `qualityRating` | string | Cars24's published vehicle quality rating. |
| `segment` | string | Published vehicle segment. |
| `marketplaceCategory` | string | Published marketplace category. |
| `firstListedAt` | string | First-listing date stated by Cars24. |
| `testDriveAvailability` | string | Published test-drive availability or terms. |
| `wishlistCount` | integer | Wishlist count stated by Cars24. |
| `equipment` | array of strings | Published vehicle equipment. |
| `photos` | array of strings | Public photo URLs. Photo files stay at the source. |
| `badges` | array of strings | Published assurance and certification badges. |
| `inspection` | array of strings | Published inspection findings and car condition details. |
| `serviceHistory` | array of strings | Published service-history details. |
| `registration` | object | Published registration details with masked numbers only. |
| `registration.maskedNumber` | string | Masked registration number. |
| `registration.registeredAt` | string | Published registration date. |
| `registration.jurisdiction` | string | Registration state or authority. |
| `location` | object | Published locality and vehicle storage location. |
| `location.city` | string | City where the car is located. |
| `location.locality` | string | Published area or locality. |
| `location.storageLocation` | string | Vehicle hub or storage location name. |
| `location.address` | string | Published vehicle storage address. |
| `financing` | object | Published installment offer and financing terms. |
| `financing.installmentAmount` | number | Installment amount in the listing currency. |
| `financing.installmentPeriod` | string | Payment period, such as monthly. |
| `financing.downPayment` | number | Down payment in the listing currency. |
| `financing.termMonths` | integer | Loan term in months. |
| `financing.interestRate` | number | Annual interest rate as a percentage. |
| `financing.terms` | string | Published financing offer terms. |

**Example listing**

This complete row comes from a successful run on the current beta build. Badges, ratings, and financing terms are source statements, not checks or promises made by this Actor.

```json
{
  "listingId": "10030570181",
  "url": "https://www.cars24.com/buy-used-volkswagen-polo-2021-cars-mumbai-10030570181",
  "make": "Volkswagen",
  "model": "Polo",
  "price": 434204,
  "currency": "INR",
  "year": 2021,
  "kilometers": 78513,
  "trim": "TRENDLINE 1.0L",
  "bodyType": "Hatchback",
  "fuelType": "Petrol",
  "transmission": "Manual",
  "color": "Red",
  "seats": 5,
  "ownerCount": 1,
  "sellerType": "Cars24 Owned Stock",
  "availability": "AVAILABLE",
  "segment": "STANDARD",
  "marketplaceCategory": "PRIME",
  "firstListedAt": "2026-09-12T12:42:02Z",
  "testDriveAvailability": "Today",
  "originalPrice": 440159,
  "onRoadPrice": 434204,
  "promotion": "1% off ₹4.40 lakh",
  "qualityRating": "Exteriors: ERROR; Engine & Transmission: OK; Air-Conditioning: OK; Electricals & Interior: OK; Steering, Suspension & Brakes: OK; Tyres(Life Remaining): OK",
  "wishlistCount": 70,
  "equipment": [
    "12V Power Outlet",
    "ABS - Anti-lock Braking System",
    "Air Conditioner",
    "Power Windows - Front",
    "Remote Trunk Release",
    "Roof-mounted Antenna",
    "Steering Adjustment",
    "Tachometer"
  ],
  "photos": [
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/878ef2fa-b300-4667-8a06-2712c68f3953/283824c7-32cd-482d-bf3a-e2d29b875911/a9e070bd-814f-4d46-b17c-719e4c5a6f56/slot/2.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/164563dc-7c1e-4055-b1af-182c41799061/283824c7-32cd-482d-bf3a-e2d29b875911/4619a53a-a908-4a3c-9e65-f30c482cb350/slot/5.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/f8fde156-297e-47e7-8fd1-acb51464226e/283824c7-32cd-482d-bf3a-e2d29b875911/3185f3b6-9a75-403c-a089-350d8dfeee91/slot/7.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/4419a49a-4de1-4702-bd69-5b17413402e7/283824c7-32cd-482d-bf3a-e2d29b875911/5f69f525-4e1d-46a6-b7c1-45c707b58d1e/slot/11.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/3e34ec18-5db6-49da-a6f4-6c9d94c36cfb/283824c7-32cd-482d-bf3a-e2d29b875911/1b6f2a86-3fb5-44d6-84ff-e929f3b8a2f7/slot/9.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/3ec766d3-ed2a-415f-91e7-c5fff244077f/slot/13.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/405f3878-bb2d-4c4e-a2fa-57ba82e1f3d4/slot/6.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/905f5789-4585-475c-b3bf-76bf86153125/slot/8.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/d0688fd2-65b4-4b65-be6e-2c62142c9322/slot/12.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/9a2e466f-a50a-4dc1-baa3-312b43c3460e/slot/10.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/db2ca8db-f278-4250-8ec4-ab245e150aa5/283824c7-32cd-482d-bf3a-e2d29b875911/ad6fd516-59d9-4276-96a2-991465fb340f/slot/3.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/acc6ec58-f209-40c4-9cc7-beef1c4423ad/283824c7-32cd-482d-bf3a-e2d29b875911/a4c8102a-c259-4ce1-8a01-ac642bebbee2/slot/2.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/04fea53e-0952-44cd-a2c7-5d1aeee058c4/slot/1.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/1018eeeb-09bf-426e-97cb-d043fd8a5077/283824c7-32cd-482d-bf3a-e2d29b875911/ae405100-8330-43b3-bdbf-6dfb004ed80d/slot/4.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/7190fa67-c7f9-4fb4-98cb-931d7c2bb765/slot/2.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/cb780f4e-bf4b-484d-80c0-00af41f42242/slot/1.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/ac535584-2524-4343-acc2-45225d383177/283824c7-32cd-482d-bf3a-e2d29b875911/9977ac24-85b2-41fe-a060-74c5d3ad5d67/slot/3.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/17005524-3273-4c28-86eb-ed225f88049f/283824c7-32cd-482d-bf3a-e2d29b875911/670f7d21-160a-4857-95ae-881175f036b0/slot/4.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/2b9f4895-e73c-4cba-b98a-0b9ba6aff51e/slot/5.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/3f1aa150-1d11-4785-8a58-336cfd7217a2/slot/6.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/fc21adb4-d461-40d3-a4fe-473fce2d7bea/slot/11.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/2bff5427-7570-4a83-8090-19b5ae2dcbcd/283824c7-32cd-482d-bf3a-e2d29b875911/c537637c-7a60-43a2-b1a4-1da7ef4d7055/slot/13.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/283824c7-32cd-482d-bf3a-e2d29b875911/f4e9cfc1-7ea1-46cd-b1eb-8f38f0df3306/slot/14.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/338e1489-ec09-4967-8c7a-2e427cb6c892/283824c7-32cd-482d-bf3a-e2d29b875911/79131364-e176-4c86-bfb2-2dca743cd70b/slot/8.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/3d4ec9fd-2f9a-4f3f-9a47-2792f527240c/283824c7-32cd-482d-bf3a-e2d29b875911/f9d68211-b994-4144-8e4b-fc69879368a8/slot/9.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/70602f1e-2c2c-4811-99e7-375a27ce1624/283824c7-32cd-482d-bf3a-e2d29b875911/d99fb5bd-14c6-4671-bcc0-699744e310fb/slot/10.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/7ce04b7d-a6cf-4cc7-864a-3f0ed0f0db41/283824c7-32cd-482d-bf3a-e2d29b875911/9cf8e80d-c363-4169-b247-b566c80b7fe5/slot/12.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/d89efc8e-542d-4d69-b1cd-9a9f81a4c245/283824c7-32cd-482d-bf3a-e2d29b875911/687eb5a8-6583-49e2-ab62-15d22315f3ac/slot/7.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/70894775-afa4-4bdf-99da-9ff935ff8a9e/283824c7-32cd-482d-bf3a-e2d29b875911/80f22ddd-7e67-4b8e-b2a0-05ab0e708426/slot/1.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/4092a751-bf6d-4825-9d33-050b07d808c7/283824c7-32cd-482d-bf3a-e2d29b875911/5e88c875-9ad7-417b-b6e5-78a6fa7308c8/slot/3.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/9a7ba201-a0e7-46c6-b0a0-4230b817b40e/283824c7-32cd-482d-bf3a-e2d29b875911/fc1a184c-26b6-4766-a151-3cc11839c259/slot/4.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/03a99ecb-859a-473e-b1df-3cb3692eaf91/283824c7-32cd-482d-bf3a-e2d29b875911/ae0239ec-5a23-4797-9d91-123360ab75c8/slot/5.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/104c63f2-7999-4fb4-8053-df135a13269f/283824c7-32cd-482d-bf3a-e2d29b875911/cfd8073a-7cdc-4463-a0e2-1a26e9e3099a/slot/6.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/701cd2d6-967a-42b5-a22c-1a0ea23e9e4d/283824c7-32cd-482d-bf3a-e2d29b875911/041fe031-3740-4579-9361-d4567d6202f8/slot/7.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/b8161a20-2289-4a38-ad86-6c8cb19d378e/283824c7-32cd-482d-bf3a-e2d29b875911/7dd945e5-b05f-4b59-a20a-a061c1b23e56/slot/8.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/e0267711-9e75-44b7-8d23-7929cdd20629/283824c7-32cd-482d-bf3a-e2d29b875911/2959e461-517c-48cf-8675-544516578f6c/slot/14.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/e8c22a05-5f93-443b-bdf5-15c8a4d0ee66/283824c7-32cd-482d-bf3a-e2d29b875911/42c8d203-0496-4b8e-a7a5-3ed0855cb107/slot/4.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/6aa3b1cc8ce2c3ec2d3266dc/e49e71f9-48fd-4f54-a94d-8516a2a4f802/slot/myTransformedImage.jpeg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/8b048940-1bf6-49f2-b7a5-886fb347c8b1/283824c7-32cd-482d-bf3a-e2d29b875911/a632a4b9-6d58-4465-b8b3-74cced55f713/slot/16.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/6aa3b1cc8ce2c3ec2d3266dc/d848c517-cc4a-41ba-84f2-0ac161a9aea0/slot/myTransformedImage.jpeg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/dc24dc92-6c7b-4323-8cf7-5aed32498766/283824c7-32cd-482d-bf3a-e2d29b875911/02059d75-0c8b-4a5a-9b39-22c201f98061/slot/1.jpg",
    "https://media.cars24.com/hello-ar/dev/transformed/uploads/43de2e42-fd24-4415-92d9-43cf102b652b/283824c7-32cd-482d-bf3a-e2d29b875911/8c3701c7-3ffe-4b11-b12a-c3e5bc156873/slot/15.jpg",
    "https://media.cars24.com/hello-ar/dev/uploads/6aa3b1cc8ce2c3ec2d3266dc/55e157c0-47f6-44e7-b252-68cf71c83bfa/slot/myTransformedImage.jpeg",
    "https://media.cars24.com/india/homepage/ExteriorDummy.png"
  ],
  "badges": [
    "Cars24 Assured",
    "Lifetime warranty",
    "30 days return",
    "300+ quality checks",
    "Best price",
    "Core structure intact",
    "No odometer tampering",
    "No water damages",
    "Inspection report available",
    "RC transfer support"
  ],
  "inspection": [
    "Dicky (Boot door): Parcel tray clips or rope are missing or broken",
    "Right fender: Slightly dented",
    "Right rear-view mirror: Minor scratches"
  ],
  "serviceHistory": [
    "Last serviced: 2026-09-13T10:29:58.169Z"
  ],
  "registration": {
    "maskedNumber": "MH03**8841",
    "registeredAt": "Mar 2021",
    "jurisdiction": "MH03"
  },
  "location": {
    "city": "Mumbai",
    "locality": "Korum Mall, Thane West",
    "storageLocation": "Cars24 Hub, Korum Mall, Thane West, Mumbai",
    "address": "Korum Mall, Shop No.S2, 2nd Floor, Opp Mr DIY, Eastern Express Hwy, Thane W, Mumbai 400606"
  },
  "financing": {
    "installmentAmount": 7665,
    "installmentPeriod": "monthly",
    "downPayment": 0,
    "termMonths": 84,
    "interestRate": 12,
    "terms": "Loans24 published used-car-loan terms: Processing fees: Up to ₹15,000/-; Pre-closure charges: Flat 5% of the outstanding loan amount"
  }
}
```

#### 💳 Pricing

One **Car listing** charge applies to each used-car listing saved to your dataset. Empty searches, skipped duplicates, and failed lookups do not create listing charges. See the Store pricing panel for current tier prices.

#### 🔌 Integrations

Use the Apify API to start runs and read saved listing rows. Export the dataset from Apify for price comparisons, inventory research, or your own data tools.

https://www.youtube.com/watch?v=bNACk1_S_6w\&list=PLObrtcm1Kw6MUrlLNDbK9QRg8VDJg0gOW\&index=4

#### ❓ FAQ

##### Can I filter by body type, fuel type, or transmission?

Yes. Use Search URLs mode and add a Cars24 India search link with supported source filters. The separate Vehicle filters fields cover city, make, model, price, year, and kilometers driven.

##### What happens if I leave Maximum listings empty?

The Actor returns all available results until the source is exhausted. Cars24 may have fewer matching listings than you expect. There is no fixed upper limit in the input field.

##### What happens when the same car appears in more than one search?

The first eligible occurrence is saved right away. Later matches for the same source listing are ignored. The row keeps the first saved match.

##### Why are some car details missing?

Optional details depend on the public listing. A car can still be saved with its required fields when photos, inspection findings, financing terms, or other optional details are unavailable.

##### Are photos downloaded?

No. The dataset contains public source photo links. The Actor does not download, change, or host the photos.

##### Is this the Cars24 official website or a car buying app in India?

No. This Actor collects public listing data from Cars24's Indian website for use in Apify. It does not buy cars, arrange financing, or act as an official Cars24 service.

##### Do I need a Cars24 login?

No. The Actor collects public listings without a customer login.

##### Does it cover Cars24 markets outside India or show price history?

No. It focuses on current public Cars24 India used-car listings. It does not provide historical change detection, forecasts, or guaranteed full inventory coverage.

### 📝 Changelog

**v0.0** (06-10-2026)

- Initial release.

### 🆘 Support

For issues, questions, or feature requests, [file a ticket](https://console.apify.com/actors/maximedupre~cars24/issues) and I'll fix or implement it in less than 24h 🫡

### 🔗 Related Actors

- [CarAndBike India Used Car Scraper](https://apify.com/maximedupre/carandbike) - Collect used-car listings from another Indian marketplace to compare prices and inventory.
- [Spinny Used Car Scraper](https://apify.com/maximedupre/spinny) - Compare Indian used-car listings from Spinny with prices and financing offers.
- [Carsales.com.au Scraper](https://apify.com/maximedupre/carsales-scraper) - Collect Australian vehicle listings for research across car markets.
- [Autotrader Scraper](https://apify.com/maximedupre/autotrader-scraper) - Collect US car listings with prices, mileage, and vehicle details.
- [Cars24 Used Cars Search Scraper](https://apify.com/stealth_mode/cars24-used-cars-search-scraper) - Explore another Cars24 listing tool for used-car market research.

**Made with ❤️ by Maxime Dupré**

# Actor input Schema

## `searchMethod` (type: `string`):

Choose how to find used cars in India.

## `searchUrls` (type: `array`):

Add one or more Cars24 India search URLs when using Search URLs. The search keeps supported filters in each link, including body type, fuel type, and transmission.

## `city` (type: `string`):

Enter an Indian city supported by Cars24, such as Mumbai. Leave blank to search the national Indian catalog.

## `make` (type: `string`):

Enter a make, such as Maruti Suzuki. Leave blank to include all makes.

## `model` (type: `string`):

Enter a model, such as Swift, and its vehicle make above. Leave blank to include all models of the selected make.

## `minPrice` (type: `integer`):

Lowest asking price in Indian rupees. Leave blank for no lower price limit.

## `maxPrice` (type: `integer`):

Highest asking price in Indian rupees. Use a value at least as high as the minimum price. Leave blank for no upper price limit.

## `minYear` (type: `integer`):

First model year to include, such as 2018. Leave blank for no lower year limit.

## `maxYear` (type: `integer`):

Last model year to include. Use a year at least as late as the earliest model year. Leave blank for no upper year limit.

## `maxKilometers` (type: `integer`):

Highest odometer reading to include, in kilometers. Leave blank for no distance limit.

## `maxItems` (type: `integer`):

Stop after this many matching listings across the run. Applies to both search methods. Leave empty to return all available results until the source is exhausted.

## Actor input object example

```json
{
  "searchMethod": "searchUrls",
  "searchUrls": [
    {
      "url": "https://www.cars24.com/buy-used-cars/"
    }
  ],
  "maxItems": 10
}
```

# Actor output Schema

## `listings` (type: `string`):

Open the collected Cars24 India used-car listings.

# 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 = {
    "searchMethod": "searchUrls",
    "searchUrls": [
        {
            "url": "https://www.cars24.com/buy-used-cars/"
        }
    ],
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("maximedupre/cars24").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 = {
    "searchMethod": "searchUrls",
    "searchUrls": [{ "url": "https://www.cars24.com/buy-used-cars/" }],
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("maximedupre/cars24").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 '{
  "searchMethod": "searchUrls",
  "searchUrls": [
    {
      "url": "https://www.cars24.com/buy-used-cars/"
    }
  ],
  "maxItems": 10
}' |
apify call maximedupre/cars24 --silent --output-dataset

```

## MCP server setup

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

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/QdhLHxlwTki0QD74L/builds/CKFuPBAlS1GIXjkGZ/openapi.json
