# Kaidee Automotive Details Scraper (`alexist/kaidee-automotive-details-scraper`) Actor

Scrape detailed automotive listings from Kaidee.com with precision. This scraper captures pricing, condition, contact info, images, and 27+ fields per vehicle — essential for dealers, market researchers, and automotive aggregators.

- **URL**: https://apify.com/alexist/kaidee-automotive-details-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 Details Scraper: Extract Used Car Listings at Scale

***

### What Is Kaidee?

Kaidee.com is Thailand's largest peer-to-peer marketplace for buying and selling used cars, motorcycles, and automotive parts. With hundreds of thousands of active listings, it's a goldmine for market data — but manually extracting vehicle details is impractical. The **Kaidee Automotive Details Scraper** automates this, delivering structured, clean datasets from individual car listings in seconds.

***

### Overview

The **Kaidee Automotive Scraper** extracts comprehensive product detail pages from Kaidee's automotive vertical (`rod.kaidee.com`), converting rich listings into exportable records. It serves:

- **Car dealers & resellers** monitoring competitor pricing and inventory
- **Market analysts** studying used vehicle valuations and trends
- **Automotive researchers** gathering data on vehicle condition, mileage, and demand
- **Aggregators & platforms** building vehicle databases for comparison sites
- **Insurance companies** collecting vehicle specification data

Strengths include bulk URL processing, flexible failure handling, and capture of 27 data fields per listing — from pricing and condition to images and seller contacts.

***

### Input Format

The scraper accepts JSON configuration with two main parameters:

```json
{
    "urls": [
        "https://rod.kaidee.com/product-371138140",
        "https://rod.kaidee.com/product-371328231",
        "https://rod.kaidee.com/product-371206655"
    ],
    "max_items_per_url": 200,
    "ignore_url_failures": true
}
```

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | Direct links to individual Kaidee automotive product pages. Each URL should point to a specific vehicle listing (e.g., `https://rod.kaidee.com/product-XXXXXXXXX`). Paste one per line or use bulk edit for prepared lists. |
| `max_items_per_url` | Integer | Maximum number of records to extract per URL. Set to `200` for complete listing capture. Lower values (e.g., `50`) reduce runtime for quick previews. |
| `ignore_url_failures` | Boolean | If `true`, continues scraping if individual URLs fail or return errors. If `false`, stops the entire run on first failure. Recommended: `true` for bulk operations. |

> **Pro tip:** Use the "Bulk edit" feature to paste 50+ URLs at once. Each URL should be a direct product link, not a search results page.

***

### Output Format

**Sample output**

```json
{
  "ad_type": {
    "id": 2,
    "name": "ขาย"
  },
  "attributes": [
    {
      "attribute": {
        "category_id": 11,
        "id": 37,
        "name_en": "mileage",
        "name_th": "เลขไมล์",
        "rank": 4,
        "required": false
      },
      "id": 19012619,
      "unit": {
        "attribute_id": 37,
        "id": 41,
        "rank": 2,
        "unit": "กิโลเมตร"
      },
      "value": "143502"
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 39,
        "name_en": "color",
        "name_th": "สี",
        "rank": 5,
        "required": false
      },
      "id": 78548760,
      "value": {
        "attribute_id": 39,
        "id": 2081,
        "rank": 2,
        "value": "ขาว",
        "value_en": "white"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 38,
        "name_en": "transmission",
        "name_th": "เกียร์",
        "rank": 9,
        "required": false
      },
      "id": 78548761,
      "value": {
        "attribute_id": 38,
        "id": 2078,
        "rank": 1,
        "value": "เกียร์อัตโนมัติ",
        "value_en": "automatic"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 3,
        "name_en": "year",
        "name_th": "ปีรถ",
        "rank": 3,
        "required": true
      },
      "id": 78548762,
      "value": {
        "attribute_id": 3,
        "id": 1553,
        "rank": 16,
        "value": "2010"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 4,
        "name_en": "fuel",
        "name_th": "เชื้อเพลิง",
        "rank": 6,
        "required": true
      },
      "id": 78548763,
      "value": {
        "attribute_id": 4,
        "id": 308,
        "rank": 1,
        "value": "เบนซิน",
        "value_en": "bensin"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 330,
        "name_en": "car_type",
        "name_th": "ประเภทรถ",
        "rank": 2,
        "required": false
      },
      "id": 78548764,
      "value": {
        "attribute_id": 330,
        "id": 4922,
        "rank": 1,
        "value": "Sedan"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 363,
        "name_en": "sub_car_type",
        "name_th": "ประเภทย่อย",
        "parent_id": 330,
        "rank": 1,
        "required": false
      },
      "id": 78548765,
      "value": {
        "attribute_id": 363,
        "parent_id": 4922,
        "id": 11381,
        "rank": 1,
        "value": "Sedan"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 1,
        "name_en": "brand",
        "name_th": "ยี่ห้อ",
        "rank": 1,
        "required": true
      },
      "id": 78548766,
      "value": {
        "attribute_id": 1,
        "id": 6,
        "rank": 2,
        "value": "Honda"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 2,
        "name_en": "model",
        "name_th": "รุ่น",
        "parent_id": 1,
        "rank": 1,
        "required": true
      },
      "id": 78548767,
      "value": {
        "attribute_id": 2,
        "parent_id": 6,
        "id": 31,
        "rank": 4,
        "value": "Accord"
      }
    },
    {
      "attribute": {
        "category_id": 11,
        "id": 331,
        "name_en": "sub_model",
        "name_th": "รุ่นย่อย",
        "parent_id": 2,
        "rank": 1,
        "required": false
      },
      "id": 78548768,
      "value": {
        "attribute_id": 331,
        "parent_id": 31,
        "id": 8453,
        "rank": 2,
        "value": "2.0 E"
      }
    }
  ],
  "category": {
    "ad_types": [
      {
        "id": 1,
        "name": "ซื้อ"
      },
      {
        "id": 2,
        "name": "ขาย"
      }
    ],
    "conditions": [
      {
        "id": 1,
        "name_en": "firsthand",
        "name_th": "มือหนึ่ง"
      },
      {
        "id": 2,
        "name_en": "secondhand",
        "name_th": "มือสอง"
      }
    ],
    "id": 11,
    "name_en": "car",
    "name_th": "รถยนต์",
    "parent_id": 1,
    "rank": 1,
    "root_id": 1,
    "children": [],
    "listing_limit": 0,
    "listing_limit_start_date": "2017-10-04"
  },
  "condition": {
    "id": 2,
    "name_en": "secondhand",
    "name_th": "มือสอง"
  },
  "contacts": [
    {
      "id": "5eb84da0-8b1e-485f-a1bb-deb628e320a4",
      "type": "telephone",
      "value": "0949535642"
    },
    {
      "id": "4fcba17c-3427-43c4-a183-ae410f989bc6",
      "type": "line",
      "value": "0949535642"
    }
  ],
  "description": "HONDA ACCORD 2.0 E น้ำมันล้วน\nเกียร์ AUTO \nปี 2010 \nรถบ้านเดิมๆ คัดสวยพิเศษ หน้า-หลังเดิม 100% ขับดี \nบอดี้เดิมโรงงาน ไม่เคยเกิดอุบัติเหตุ ไม่เคยจมน้ำ \n\nTel. 0949535642",
  "district": {
    "id": 153,
    "name_en": "Phanat Nikhom",
    "name_th": "พนัสนิคม",
    "province": {
      "districts": [],
      "id": 16,
      "name_en": "chonburi",
      "name_th": "ชลบุรี",
      "rank": 9
    }
  },
  "expiration_time": "",
  "id": "433d1128-080d-450b-bdcc-d72dc2985713",
  "images": [
    {
      "id": "2ecac67c-c194-4213-882f-0674fc29aee7",
      "sequence": 1,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/96b95cc4-e2b0-40e7-9d44-a6dfb221c2a0.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/96b95cc4-e2b0-40e7-9d44-a6dfb221c2a0.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/96b95cc4-e2b0-40e7-9d44-a6dfb221c2a0.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/96b95cc4-e2b0-40e7-9d44-a6dfb221c2a0.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "23bc8462-a19c-4e1b-9be9-98d833bc50d2",
      "sequence": 2,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/92001324-7885-43a4-84d7-9adb966860a6.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/92001324-7885-43a4-84d7-9adb966860a6.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/92001324-7885-43a4-84d7-9adb966860a6.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/92001324-7885-43a4-84d7-9adb966860a6.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "c18c0799-982d-44dc-8039-a2ca573ebc57",
      "sequence": 3,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/ab95e739-85f0-4d3a-bdb9-59f84166e7bd.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/ab95e739-85f0-4d3a-bdb9-59f84166e7bd.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/ab95e739-85f0-4d3a-bdb9-59f84166e7bd.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/ab95e739-85f0-4d3a-bdb9-59f84166e7bd.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "3cdc9fc9-49a3-4595-bf17-245ade72fb8f",
      "sequence": 4,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/785d8d44-1bd6-4151-b368-c46b39a205dc.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/785d8d44-1bd6-4151-b368-c46b39a205dc.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/785d8d44-1bd6-4151-b368-c46b39a205dc.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/785d8d44-1bd6-4151-b368-c46b39a205dc.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "39d4862c-b1b7-4d01-a04d-e328ff8c1e46",
      "sequence": 5,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/1b33eaec-0732-44c5-a472-7d729b6c076e.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/1b33eaec-0732-44c5-a472-7d729b6c076e.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/1b33eaec-0732-44c5-a472-7d729b6c076e.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/1b33eaec-0732-44c5-a472-7d729b6c076e.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "a3e37211-0a72-4523-8b36-df5898c9e947",
      "sequence": 6,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/ccab3e99-6a85-476b-ae17-965627fae46a.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/ccab3e99-6a85-476b-ae17-965627fae46a.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/ccab3e99-6a85-476b-ae17-965627fae46a.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/ccab3e99-6a85-476b-ae17-965627fae46a.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "18210c35-84c2-4ee5-8b0c-2f432a3aa9bd",
      "sequence": 7,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/c03f9940-4d2d-4bcf-b4e2-ce249193d847.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/c03f9940-4d2d-4bcf-b4e2-ce249193d847.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/c03f9940-4d2d-4bcf-b4e2-ce249193d847.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/c03f9940-4d2d-4bcf-b4e2-ce249193d847.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "2f683af9-372a-40be-bbf6-fb0d4383d73f",
      "sequence": 8,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/fb0472f0-f078-4659-b95a-556cc9629c93.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/fb0472f0-f078-4659-b95a-556cc9629c93.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/fb0472f0-f078-4659-b95a-556cc9629c93.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/fb0472f0-f078-4659-b95a-556cc9629c93.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "14937e9c-5155-4607-b74e-7b02e41316d6",
      "sequence": 9,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/6ad00a7a-bc18-4010-a3c2-3c89f196d589.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/6ad00a7a-bc18-4010-a3c2-3c89f196d589.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/6ad00a7a-bc18-4010-a3c2-3c89f196d589.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/6ad00a7a-bc18-4010-a3c2-3c89f196d589.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "34c6df7c-8600-4b94-b996-e850e683d25b",
      "sequence": 10,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/3688e25f-156e-4e6c-ac51-b11797c64dfb.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/3688e25f-156e-4e6c-ac51-b11797c64dfb.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/3688e25f-156e-4e6c-ac51-b11797c64dfb.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/3688e25f-156e-4e6c-ac51-b11797c64dfb.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "674e8a45-ea4f-4205-b602-dff2022e383d",
      "sequence": 11,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/9678a528-8e85-4008-8e2b-dbda20858abb.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/9678a528-8e85-4008-8e2b-dbda20858abb.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/9678a528-8e85-4008-8e2b-dbda20858abb.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/9678a528-8e85-4008-8e2b-dbda20858abb.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "3e081fb6-f185-43f1-87bf-d4cbc5a0e034",
      "sequence": 12,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/28815c16-95c0-43a8-be10-43bfb384d268.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/28815c16-95c0-43a8-be10-43bfb384d268.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/28815c16-95c0-43a8-be10-43bfb384d268.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/28815c16-95c0-43a8-be10-43bfb384d268.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "f9ee40d9-cd7e-475b-9204-8cabc174de4e",
      "sequence": 13,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/f316dc9a-4fc6-46a5-ac21-573d13e05dc9.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/f316dc9a-4fc6-46a5-ac21-573d13e05dc9.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/f316dc9a-4fc6-46a5-ac21-573d13e05dc9.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/f316dc9a-4fc6-46a5-ac21-573d13e05dc9.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "496aa05e-008f-4536-9544-e44a52959473",
      "sequence": 14,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/2a9a508b-6966-46ba-8e38-97238dbc467f.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/2a9a508b-6966-46ba-8e38-97238dbc467f.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/2a9a508b-6966-46ba-8e38-97238dbc467f.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/2a9a508b-6966-46ba-8e38-97238dbc467f.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "90f18b56-8bbb-4bac-a5ab-8d54f98b9240",
      "sequence": 15,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/a11af1b6-82a2-4f7e-925e-69b30df3911e.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/a11af1b6-82a2-4f7e-925e-69b30df3911e.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/a11af1b6-82a2-4f7e-925e-69b30df3911e.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/a11af1b6-82a2-4f7e-925e-69b30df3911e.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "e4e9148a-5a94-4ee8-83eb-7da2d2ede0ad",
      "sequence": 16,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/d14c170c-8242-4094-a01a-abfb16fd05d8.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/d14c170c-8242-4094-a01a-abfb16fd05d8.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/d14c170c-8242-4094-a01a-abfb16fd05d8.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/d14c170c-8242-4094-a01a-abfb16fd05d8.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    },
    {
      "id": "7830775e-94fe-4df7-afb8-ca9f2a006ef5",
      "sequence": 17,
      "sizes": {
        "large": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/b/d74c90ea-11b8-4208-9a89-8f24b554fdd0.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "medium": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/m/d74c90ea-11b8-4208-9a89-8f24b554fdd0.jpg",
          "resolution": {
            "height": 421,
            "width": 750
          }
        },
        "original": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/original/d74c90ea-11b8-4208-9a89-8f24b554fdd0.jpg",
          "resolution": {
            "height": 450,
            "width": 800
          }
        },
        "thumb": {
          "link": "https://img.kaidee.com/prd/20251216/371138140/t/d74c90ea-11b8-4208-9a89-8f24b554fdd0.jpg",
          "resolution": {
            "height": 180,
            "width": 320
          }
        }
      }
    }
  ],
  "item_id": 371138140,
  "legacy_id": 371138140,
  "locations": [
    {
      "id": "f503ffaf-d9fc-4b08-92e0-4df6c9142ed8",
      "latitude": "13.4522222",
      "longitude": "101.1772222"
    }
  ],
  "member": {
    "display_image": "https://graph.facebook.com/1769568193247876/picture?width=140&height=140",
    "email": "",
    "id": 12677311,
    "name": "Golfy",
    "telephone": "0949535642"
  },
  "price": 229000,
  "status": "live",
  "system_created_time": "2025-12-16T20:02:23.635413+07:00",
  "system_modified_time": "2026-07-03T10:10:57.896447+07:00",
  "title": "HONDA ACCORD 2.0 E AUTO ปี 2010 ",
  "version": "v9",
  "delivery_types": [],
  "first_approved_time": "2025-12-16T20:03:15.942993+07:00",
  "listing_type": "hot",
  "package_type": "hot",
  "themes": [],
  "weight": null,
  "ad_youtubes": []
}
```

Each scraped vehicle returns a comprehensive record with 27+ fields:

#### Listing Identification

| Field | Meaning | Example |
|---|---|---|
| `ID` | Unique internal Kaidee ID | `371138140` |
| `Item ID` | Alternative identifier for the product | `371138140` |
| `Legacy ID` | Historical identifier for older listings | `null` or legacy number |
| `Title` | Vehicle name/title as displayed | `Toyota Camry 2015 Auto Full Option` |
| `Status` | Current listing status | `active`, `sold`, `expired` |
| `Version` | Data structure version | Integer (e.g., `2`) |

#### Vehicle Details & Condition

| Field | Meaning | Example |
|---|---|---|
| `Condition` | Vehicle condition descriptor | `Used`, `Like New`, `Fair` |
| `Category` | Product category type | `Automobiles` |
| `Ad Type` | Type of ad placement | `Regular`, `Premium`, `Urgent` |
| `Attributes` | Structured vehicle specs (make, model, year, mileage, engine, transmission, etc.) | `{"make": "Toyota", "model": "Camry", "year": 2015, "mileage": 85000}` |

#### Pricing & Listing Details

| Field | Meaning | Example |
|---|---|---|
| `Price` | Listed vehicle price in Thai Baht | `899000` |
| `Package Type` | Listing package tier | `Standard`, `Featured`, `Urgent Sale` |
| `Listing Type` | How the vehicle is offered | `For Sale`, `Trade-In Wanted` |
| `Delivery Types` | Shipping/delivery options offered | `["Pickup", "Delivery Available"]` |
| `Themes` | Visual theme/styling applied to listing | `"Classic"`, `"Highlight"` |

#### Location & Contact Information

| Field | Meaning | Example |
|---|---|---|
| `Locations` | Detailed location object (GPS, address) | `{"district": "Bangkapi", "city": "Bangkok", "province": "Bangkok"}` |
| `District` | Administrative district name | `Bangkapi` |
| `Member` | Seller profile info (name, ID, rating) | `{"username": "dealer123", "rating": 4.8}` |
| `Contacts` | Seller contact methods | `{"phone": "+66812345678", "line": "seller_id"}` |

#### Media & Visual Content

| Field | Meaning | Example |
|---|---|---|
| `Images` | Array of product image URLs | `["https://images.kaidee.com/img1.jpg", "https://images.kaidee.com/img2.jpg"]` |
| `Ad Youtubes` | Embedded YouTube video URLs (if any) | `["https://youtube.com/watch?v=..."]` |
| `Weight` | Vehicle weight if specified | `1450` (kg) |

#### Temporal Data

| Field | Meaning | Example |
|---|---|---|
| `System Created Time` | When the listing was created | `2024-01-15T10:30:00Z` |
| `System Modified Time` | Last update timestamp | `2024-01-20T14:22:00Z` |
| `First Approved Time` | When listing was first approved | `2024-01-15T10:45:00Z` |
| `Expiration Time` | When the listing will expire | `2024-04-15T10:30:00Z` |
| `Description` | Full product description & seller notes | Long text describing vehicle history, condition, maintenance records |

***

### How to Use

1. **Gather URLs** — Visit Kaidee.com's automotive section, find vehicles you want to track, and copy the product URL from the address bar (e.g., `https://rod.kaidee.com/product-371138140`).

2. **Prepare input** — Paste URLs into the `urls` array. For 10–100 URLs, use the Bulk edit feature to paste a prepared list all at once.

3. **Set parameters** — Leave `max_items_per_url` at `200` for full extraction. Set `ignore_url_failures` to `true` if running bulk jobs (some URLs may be delisted).

4. **Execute the scraper** — Start the run and monitor progress in the logs.

5. **Export results** — Download as JSON, CSV, or Excel. Import into spreadsheets, databases, or analytics tools.

**Troubleshooting:**

- **Empty results** — Confirm the URL is a product detail page, not a search or category page. URLs must start with `https://rod.kaidee.com/product-`.
- **Rate limiting** — If many URLs fail, Kaidee may be rate-limiting. Stagger your runs or reduce batch sizes.
- **Missing images** — Image URLs may expire after 24–48 hours; download images immediately after scraping if archiving is needed.

***

### Business Applications

- **Inventory monitoring** — Track dealer stock and pricing in real time
- **Market valuation** — Analyze used car price trends by model, year, and condition
- **Competitive intelligence** — Monitor competitor listings and adjust pricing strategy
- **Lead generation** — Extract seller contact information for outreach campaigns
- **Academic research** — Study used vehicle markets and consumer behavior in Thailand
- **Price aggregation** — Build automotive comparison platforms with live Kaidee data

A single scrape can deliver hundreds of vehicle records complete with images, pricing, and seller info — replacing hours of manual work.

***

### Conclusion

The **Kaidee Automotive Details Scraper** transforms Thailand's largest used-car marketplace into actionable data. Whether you're a dealer, analyst, or platform builder, this tool captures everything needed to make informed decisions — condition, price, seller contact, images, and 20+ additional fields. Start scraping today and gain competitive advantage in the automotive market.

# Actor input Schema

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

Add the URLs of the Specific cars 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.

## Actor input object example

```json
{
  "urls": [
    "https://rod.kaidee.com/product-371138140",
    "https://rod.kaidee.com/product-371328231",
    "https://rod.kaidee.com/product-371206655",
    "https://rod.kaidee.com/product-371472082",
    "https://rod.kaidee.com/product-371485300"
  ],
  "ignore_url_failures": true
}
```

# 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/product-371138140",
        "https://rod.kaidee.com/product-371328231",
        "https://rod.kaidee.com/product-371206655",
        "https://rod.kaidee.com/product-371472082",
        "https://rod.kaidee.com/product-371485300"
    ],
    "ignore_url_failures": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("alexist/kaidee-automotive-details-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/product-371138140",
        "https://rod.kaidee.com/product-371328231",
        "https://rod.kaidee.com/product-371206655",
        "https://rod.kaidee.com/product-371472082",
        "https://rod.kaidee.com/product-371485300",
    ],
    "ignore_url_failures": True,
}

# Run the Actor and wait for it to finish
run = client.actor("alexist/kaidee-automotive-details-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/product-371138140",
    "https://rod.kaidee.com/product-371328231",
    "https://rod.kaidee.com/product-371206655",
    "https://rod.kaidee.com/product-371472082",
    "https://rod.kaidee.com/product-371485300"
  ],
  "ignore_url_failures": true
}' |
apify call alexist/kaidee-automotive-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,alexist/kaidee-automotive-details-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/h4Q1cQFO8A8l5yBWl/builds/rFgNzuZioCn9ssGq3/openapi.json
