# Kaidee Automotive Search Scraper (`alexist/kaidee-automotive-search-scraper`) Actor

Scrape vehicle listings from Kaidee's automotive catalog with complete data extraction. Collect prices, images, seller details, vehicle specs, and 20+ fields per listing — perfect for market researchers, dealers, and inventory managers.

- **URL**: https://apify.com/alexist/kaidee-automotive-search-scraper.md
- **Developed by:** [Alex](https://apify.com/alexist) (community)
- **Categories:** Automation, Developer tools, Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

## Kaidee Automotive Search Scraper: Extract Car Listings Efficiently

***

### What Is Kaidee?

Kaidee is Southeast Asia's leading online marketplace for automotive transactions, hosting thousands of new and used vehicle listings daily. From compact cars to commercial vehicles, Kaidee connects buyers and sellers across the region. Manually extracting vehicle data, pricing trends, and seller information is labor-intensive — the **Kaidee Automotive Search Scraper** automates this process, delivering structured automotive data at scale.

***

### Overview

The **Kaidee Automotive Search Scraper** extracts detailed vehicle listings from Kaidee's automotive category pages, converting raw marketplace data into clean, structured records. It is ideal for:

- **Used car dealers** monitoring market inventory and pricing
- **Market researchers** analyzing automotive trends and pricing patterns
- **Data analysts** building vehicle price databases
- **Platform aggregators** feeding automotive listings into comparison tools
- **Automotive consultants** tracking competitor vehicle stock

Key advantages include flexible item limits per URL, configurable failure handling, and comprehensive data covering vehicle specs, pricing, seller contact info, and listing metadata.

***

### Input Format

The scraper accepts a JSON configuration object:

```json
{
  "urls": [
    "https://rod.kaidee.com/c11-auto-car"
  ],
  "max_items_per_url": 200,
  "ignore_url_failures": true
}
```

| Field | Description |
|---|---|
| `urls` | Array of Kaidee automotive category or search result URLs. Example: `https://rod.kaidee.com/c11-auto-car` |
| `max_items_per_url` | Maximum vehicle listings to extract per URL (e.g., `200`) |
| `ignore_url_failures` | If `true`, continues scraping if some URLs fail; if `false`, stops on any error |

> **Tip:** Use category URLs like `https://rod.kaidee.com/c11-auto-car` for broad automotive searches, or append filters for specific vehicle types or price ranges.

***

### Output Format

**Sample output**

```json
{
  "image": "https://img.kaidee.com/prd/20260706/371452880/m/0180ee8f-0820-4314-a410-5b651beec29d.jpg",
  "price": 269000,
  "title": "Mg Zs D 2019",
  "location": "บางแค กรุงเทพมหานคร",
  "type": "standard",
  "attributes": [],
  "category_id": 11,
  "category_name": "รถยนต์",
  "condition_name": "มือสอง",
  "contact_info": {
    "chat": "11064335",
    "line": "@ceooat",
    "email": null,
    "phone": "0983249988"
  },
  "first_approved_time": "2026-07-06T12:20:32.003831+07:00",
  "flag": [
    "hot"
  ],
  "id": 371452880,
  "image_alt": "รถ MG ZS 1.5 D สี ดำ",
  "member": {
    "avatar_url": "https://img.kaidee.com/profile/11064335/ca2d5fed-7a5e-4704-ba06-81ec3f806ac9.jpg",
    "name": "Carwin",
    "role": "auto_owner"
  },
  "member_id": 11064335,
  "purpose_name": "ขาย",
  "themes": [],
  "tracking": {
    "gtm_data": {
      "category_id_breadcrumb": ";c001;1;11;",
      "brand": "MG",
      "model": "ZS",
      "fuel_type": "bensin",
      "year": "2019",
      "mileage": "140000",
      "website_section": "auto",
      "listing_id": 371452880,
      "package_type": "hot",
      "price": 269000,
      "loc_id_breadcrumb": ";1;9;20;",
      "seller_ids": 11064335
    },
    "pixel_data": {
      "s": "merchant",
      "t": "LIST_ADS_IMPRESSION",
      "timestamp": "2026-07-28T16:18:49Z",
      "behavior": "browse",
      "page_number": "1",
      "pos": "1",
      "version": "2",
      "category_id": "11",
      "category_path": "11"
    }
  },
  "auto_info": {
    "brand": "MG",
    "car_type": "Sedan",
    "dealership": {
      "name": "Car Win",
      "image": "https://img.kaidee.com/profile/12946170/ee163080-30a2-4db1-9572-39c7345a2cc6.jpg"
    },
    "fuel_type": "เบนซิน",
    "mileage": "140000",
    "model": "ZS",
    "submodel": "1.5 D",
    "transmission": "เกียร์อัตโนมัติ",
    "year": "2019"
  },
  "from_url": "https://rod.kaidee.com/c11-auto-car"
}
```

Each scraped vehicle listing returns a comprehensive record with 20+ fields:

#### Vehicle Identification & Pricing

| Field | Meaning |
|---|---|
| `ID` | Unique Kaidee identifier for the vehicle listing |
| `Title` | Vehicle name/description as listed (e.g., "2018 Toyota Vios 1.5 G") |
| `Price` | Listed sale price in local currency |
| `Image` | Primary vehicle image URL |
| `Image Alt` | Alternate image URL or additional vehicle photos |
| `Condition Name` | Vehicle condition category (e.g., "Like New", "Good", "Fair") |

#### Vehicle Specifications

| Field | Meaning |
|---|---|
| `Type` | Vehicle type classification (e.g., sedan, SUV, truck, hatchback) |
| `Auto Info` | Extended vehicle details (model year, engine size, mileage, transmission type, fuel type, etc.) |
| `Attributes` | Additional vehicle features or specifications stored as structured attributes |
| `Purpose Name` | Vehicle intended use (e.g., personal, taxi, commercial) |

#### Listing & Category Data

| Field | Meaning |
|---|---|
| `Category ID` | Numeric ID for the automotive category |
| `Category Name` | Category description (e.g., "Cars") |
| `Location` | Geographic location where the vehicle is offered |
| `Themes` | Visual themes or special listing badges applied |
| `Flag` | Any flags or alerts on the listing (e.g., "Verified", "Urgent Sale") |
| `First Approved Time` | Timestamp when Kaidee first approved the listing for publication |

#### Seller & Contact Information

| Field | Meaning |
|---|---|
| `Member` | Seller's username or display name |
| `Member ID` | Unique identifier for the seller account |
| `Contact Info` | Seller's phone, email, or messaging details for inquiries |

#### Tracking & Analytics

| Field | Meaning |
|---|---|
| `Tracking` | Internal Kaidee tracking codes for analytics and reporting |

***

### How to Use

1. **Gather target URLs** — Navigate to Kaidee automotive (https://rod.kaidee.com/c11-auto-car) or apply filters for specific vehicle types, brands, or price ranges. Copy the resulting category or search URL.
2. **Build your input** — Paste one or more URLs into the `urls` array. Set `max_items_per_url` based on your data needs (e.g., `50` for quick samples, `200` for comprehensive datasets).
3. **Configure error handling** — Set `ignore_url_failures` to `true` if scraping multiple URLs to ensure partial failures don't halt the entire run.
4. **Start the scraper** — Execute the actor and monitor progress via the run log.
5. **Download results** — Export data in JSON or CSV format for analysis in spreadsheets or databases.

**Best practices:**

- Start with a single URL and smaller `max_items_per_url` to test configuration before scaling.
- Use category URLs rather than search result pages for more stable data.
- Respect Kaidee's Terms of Service and robots.txt when planning scrape frequency.

***

### Use Cases & Business Value

- **Price benchmarking:** Track used vehicle pricing by model, year, and condition across the region
- **Inventory monitoring:** Compare competitor stock levels and vehicle availability
- **Market intelligence:** Identify trending vehicle brands, types, and features
- **Data aggregation:** Feed automotive listings into comparison platforms or pricing tools
- **Research datasets:** Analyze supply-demand patterns and seasonal trends in the automotive market

The Kaidee Automotive Search Scraper eliminates hours of manual browsing, delivering structured, ready-to-analyze data that powers business decisions in real time.

***

### Conclusion

The **Kaidee Automotive Search Scraper** is a powerful tool for anyone needing reliable, structured vehicle listing data from Kaidee's marketplace. With 20+ fields covering prices, specs, seller info, and listing metadata, it transforms unstructured marketplace data into actionable intelligence. Start scraping today and unlock insights into automotive market trends and pricing patterns.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the automotive list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## `max_items_per_url` (type: `integer`):

The maximum number of items to scrape per URL.

## Actor input object example

```json
{
  "urls": [
    "https://rod.kaidee.com/c11-auto-car"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}
```

# 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 = {
    "urls": [
        "https://rod.kaidee.com/c11-auto-car"
    ],
    "ignore_url_failures": true,
    "max_items_per_url": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/kaidee-automotive-search-scraper").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 = {
    "urls": ["https://rod.kaidee.com/c11-auto-car"],
    "ignore_url_failures": True,
    "max_items_per_url": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/kaidee-automotive-search-scraper").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 '{
  "urls": [
    "https://rod.kaidee.com/c11-auto-car"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 100
}' |
apify call alexist/kaidee-automotive-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexist/kaidee-automotive-search-scraper"
        }
    }
}

```

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/jzJOwxMDZ0kwyNzZL/builds/4h8Ctnjs6NKE0Osvm/openapi.json