# KB Chachacha Scraper — Korean Used Car Listings (Encar alt.) (`kdatafactory/kbchachacha-scraper`) Actor Scrape KB Chachacha (KB차차차), Korea's #2 used-car marketplace (~168k live listings): make, model, trim, year, KRW price, mileage, region and image as clean JSON. No dealer PII. Pairs with encar-scraper for used-car export sourcing across Korea's two biggest markets. - **URL**: https://apify.com/kdatafactory/kbchachacha-scraper.md - **Developed by:** [Seok June Park](https://apify.com/kdatafactory) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## KB Chachacha Scraper — Korean Used Cars 🚗 Scrape live **used-car listings** from [KB Chachacha (KB차차차)](https://www.kbchachacha.com) — Korea's **#2 used-car marketplace** (~168k active listings) — as clean, structured JSON. Get make, model, trim, year, price (KRW), mileage, and region for every vehicle in one run. The perfect **second inventory source** next to Encar: bundle the two and you cover the vast majority of Korea's used-car market for **export sourcing**, price analytics, and market research. See [encar-scraper](https://apify.com/kdatafactory/encar-scraper) for the sibling actor. > **Try it free.** Apify's free plan includes $5 of monthly platform credit — at **$2.00 / 1,000 results** that's roughly **2,500 vehicles** from this actor, no credit card required. Set your input, click Start, and export JSON/CSV/Excel. --- ### What it does This actor reads listing data straight from KB Chachacha's own public search feed (the same endpoint the website calls as you browse), so results are fast and complete — no fragile full-page scraping, no headless browser. You can scrape: - **The whole marketplace** (all makes, domestic + imported), or - **A specific make** (e.g. Hyundai, Genesis, Mercedes-Benz), or - **A specific make + model** (e.g. Kia → K5). Results can be sorted by newest listed, price, mileage, or model year. > **Why KB Chachacha?** Korea is one of the world's largest used-car **export** markets, and KB Chachacha — run by KB Kookmin Card — is the #2 marketplace after Encar. Exporters who already pull Encar use KB Chachacha as their second sourcing feed to widen inventory and catch cars the other market doesn't list. This actor turns that feed into a structured dataset you can filter, price-model, and pipe into your own tools. --- ### Input | Field | Type | Description | |-------|------|-------------| | `manufacturer` | string | Optional make filter. A Korean **or** English make name — e.g. `현대`/`Hyundai`, `기아`/`Kia`, `제네시스`/`Genesis`, `벤츠`/`Mercedes-Benz`, `BMW`, `테슬라`/`Tesla` — or a raw KB Chachacha `makerCode` (e.g. `101`). Blank = all makes. | | `model` | string | Optional model-group filter (requires `manufacturer`), e.g. `그랜저`, `K5`, `아반떼`. Blank = all models. | | `sort` | string | `newest`, `price_asc`, `price_desc`, `mileage_asc`, `mileage_desc`, or `year_desc`. Default `newest`. | | `maxItems` | integer | Max listings to collect. Default `100`, max `10000`. | | `proxyConfiguration` | object | Proxy settings (see below). Defaults to a direct connection. | #### Input example ```json { "manufacturer": "현대", "model": "그랜저", "sort": "price_asc", "maxItems": 200 } ```` ```json { "manufacturer": "Mercedes-Benz", "sort": "newest", "maxItems": 500 } ``` *** ### Output Each vehicle listing is one dataset record. `price_krw` is the full price in Korean won (KB Chachacha shows prices in 만원 / 10,000-won units — this actor converts them to plain KRW). `mileage_km` is in kilometres. `region` is the coarse city/province where the car is listed. `title` keeps the full original vehicle name. ```json { "source": "kbchachacha", "listing_id": "28251610", "make": "기아", "make_en": "Kia", "model": "디 올 뉴 니로", "trim": "1.6 HEV 프레스티지", "title": "기아 디 올 뉴 니로 1.6 HEV 프레스티지", "year": 2022, "price_krw": 15900000, "mileage_km": 139000, "fuel": "하이브리드", "transmission": null, "region": "인천", "url": "https://www.kbchachacha.com/public/car/detail.kbc?carSeq=28251610", "image_url": "https://img.kbchachacha.com/IMG/carimg/l/img05/img2825/28251610_2202953277335123.jpg", "scraped_at": "2026-07-13T12:12:04+09:00" } ``` A full 40-item sample from a real run is in [`samples/sample-output.json`](samples/sample-output.json). | Field | Meaning | |-------|---------| | `source` | Always `"kbchachacha"`. | | `listing_id` | KB Chachacha vehicle `carSeq`. | | `make` | Manufacturer, as KB Chachacha labels it (Korean). | | `make_en` | English make name for common brands, else `null`. | | `model` | Model group, parsed from the title. | | `trim` | Trim / grade, parsed from the title, else `null`. | | `title` | Full original vehicle name (authoritative). | | `year` | Model year (4-digit). | | `price_krw` | Asking price in KRW. | | `mileage_km` | Odometer reading in km. | | `fuel` | Fuel type when stated in the title (가솔린 = petrol, 디젤 = diesel, 전기 = electric, 하이브리드 = hybrid…), else `null`. See limitations. | | `transmission` | Always `null` — not exposed on the public list (see limitations). | | `region` | Coarse listing region (province/city). | | `url` | Listing detail page URL. | | `image_url` | Main photo URL. | | `scraped_at` | ISO-8601 timestamp (KST, UTC+9). | The core fields — `make`, `model`, `year`, `price_krw`, `mileage_km`, `region`, `url`, `image_url`, `title` — populated on **40/40** records in the live test. `trim` (24/40) and `fuel` (20/40) are best-effort from the listing title, and `transmission` is always null (see Known limitations). *** ### Use cases - **Used-car export sourcing** — build a live, filterable catalogue of Korean used cars (with photos, price, mileage, and year) to source vehicles for export. Run this **alongside [encar-scraper](https://apify.com/kdatafactory/encar-scraper)** to cover Korea's two biggest markets in one pipeline. - **Price & depreciation analytics** — track `price_krw` against year, mileage, make, and model to model residual values and spot underpriced listings across a second marketplace. - **Market & inventory research** — measure supply by brand and region across ~168k listings, and compare KB Chachacha vs Encar inventory. - **AI agents & datasets** — feed structured used-car data into pricing models, dashboards, or LLM agents. *** ### ❓ FAQ **Is it legal to scrape this data?** This actor collects only public, non-personal listing data — the same used-car listings any visitor sees on kbchachacha.com without logging in. No personal or dealer data is collected. You are responsible for how you use the data; see the legality note below. **What does it cost in practice?** $2.00 per 1,000 results (launch pricing) + a few cents of platform usage. Example: a 500-result daily pull costs about **$1.00/day**. Apify's free $5 monthly credit covers **~2,500 results** (5 ÷ 2 × 1,000). **Do I need to configure proxies?** No — the default settings work out of the box. KB Chachacha serves its listing feed without a bot wall, so the actor runs fine on a **direct connection**. For very heavy pulls you can optionally enable Apify Proxy — see the proxy note below. **How fresh is the data?** Every run scrapes the live KB Chachacha feed at run time. Schedule the actor for recurring snapshots (e.g. daily price tracking). **What is NOT included?** Transmission (it isn't shown on the public list, only on the per-vehicle detail page that also carries dealer PII we deliberately don't fetch) and dealer contact details. Fuel is best-effort — populated only when the listing title states it. Make/model/fuel/region come as Korean strings, with a `make_en` convenience field for common brands. *** ### 🤖 Use with AI agents (MCP) Call this Actor as a tool from Claude or any MCP-compatible AI agent — no glue code. Point your MCP client at Apify's server, scoped to this Actor: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=kdatafactory/kbchachacha-scraper", "headers": { "Authorization": "Bearer " } } } } ``` Your agent can then pull KB Chachacha used-car listings and export-market data on demand — no scraping code in your app. Grab a free token from [Apify → Integrations](https://console.apify.com/settings/integrations). ### 🇰🇷 More Korean data actors This actor is part of a suite of Korean-platform scrapers by the same maintainer: - **[encar-scraper](https://apify.com/kdatafactory/encar-scraper) — used-car listings from Encar, Korea's #1 marketplace.** Run it together with this actor for full used-car export coverage. - [joongna-scraper](https://apify.com/kdatafactory/joongna-scraper) — secondhand-goods listings from Joongna, Korea's largest used-goods market. - [bunjang-scraper](https://apify.com/kdatafactory/bunjang-scraper) — live product listings from Bunjang, Korea's top C2C resale app. Browse all: [apify.com/kdatafactory](https://apify.com/kdatafactory) *** ### Rate limiting & legality - The actor collects **only public, non-authenticated data**. It never logs in and never touches private endpoints. - **No personal / dealer data** is collected. This actor deliberately does **not** fetch KB Chachacha's per-vehicle detail page, which carries dealer names and phone numbers. Only vehicle attributes and a coarse listing region are returned. - Requests are rate-limited: one page at a time with a ≥ 500 ms delay between requests, to stay gentle on KB Chachacha's servers. - You are responsible for using the data in line with KB Chachacha's terms of service and applicable law. #### Known limitations (honesty note) - **Transmission** is not included (always `null`). It isn't shown on the public list feed — it's only on the per-vehicle detail page, which also exposes dealer PII, so per our privacy rules we don't fetch it (same policy as [encar-scraper](https://apify.com/kdatafactory/encar-scraper)). - **Fuel** is **best-effort**: it's populated only when the listing title states it (≈50% of listings in the live test) and is `null` otherwise. It is not billed as a guaranteed field. - **`model` / `trim`** are parsed heuristically from the listing title. The authoritative, always-present full vehicle name is kept in the **`title`** field; `trim` is `null` when it can't be split out. - **Make/model/region are Korean strings** (a `make_en` convenience field is provided for common brands). Model and trim are not translated. *** *If this actor saves you time, a rating on the [Store page](https://apify.com/kdatafactory/kbchachacha-scraper) helps a solo maintainer a lot. Found an issue? Open it in the Issues tab — I respond fast.* # Actor input Schema ## `manufacturer` (type: `string`): Optional filter by manufacturer. Accepts a Korean or English make name — e.g. '현대'/'Hyundai', '기아'/'Kia', '제네시스'/'Genesis', '벤츠'/'Mercedes-Benz', 'BMW', '테슬라'/'Tesla' — or a raw KB Chachacha makerCode (e.g. 101). Leave blank for all makes. ## `model` (type: `string`): Optional model-group filter, requires manufacturer to be set. Korean model name as KB Chachacha labels it, e.g. '그랜저', 'K5', '아반떼', or a raw classCode. Leave blank for all models of the chosen make. ## `sort` (type: `string`): How to order the listing feed before collecting. ## `maxItems` (type: `integer`): Maximum number of vehicle listings to collect. ## `proxyConfiguration` (type: `object`): Proxy settings. KB Chachacha serves listings without a bot wall, so the actor runs fine on a direct connection (default). If you ever see blocks at high volume, enable Apify Proxy here. ## Actor input object example ```json { "manufacturer": "", "model": "", "sort": "newest", "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("kdatafactory/kbchachacha-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("kdatafactory/kbchachacha-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call kdatafactory/kbchachacha-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kdatafactory/kbchachacha-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "KB Chachacha Scraper — Korean Used Car Listings (Encar alt.)", "description": "Scrape KB Chachacha (KB차차차), Korea's #2 used-car marketplace (~168k live listings): make, model, trim, year, KRW price, mileage, region and image as clean JSON. No dealer PII. Pairs with encar-scraper for used-car export sourcing across Korea's two biggest markets.", "version": "0.1", "x-build-id": "bimSvdfmeUegGhsNi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kdatafactory~kbchachacha-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kdatafactory-kbchachacha-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/kdatafactory~kbchachacha-scraper/runs": { "post": { "operationId": "runs-sync-kdatafactory-kbchachacha-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/kdatafactory~kbchachacha-scraper/run-sync": { "post": { "operationId": "run-sync-kdatafactory-kbchachacha-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "manufacturer": { "title": "Manufacturer (make)", "type": "string", "description": "Optional filter by manufacturer. Accepts a Korean or English make name — e.g. '현대'/'Hyundai', '기아'/'Kia', '제네시스'/'Genesis', '벤츠'/'Mercedes-Benz', 'BMW', '테슬라'/'Tesla' — or a raw KB Chachacha makerCode (e.g. 101). Leave blank for all makes.", "default": "" }, "model": { "title": "Model group", "type": "string", "description": "Optional model-group filter, requires manufacturer to be set. Korean model name as KB Chachacha labels it, e.g. '그랜저', 'K5', '아반떼', or a raw classCode. Leave blank for all models of the chosen make.", "default": "" }, "sort": { "title": "Sort order", "enum": [ "newest", "price_asc", "price_desc", "mileage_asc", "mileage_desc", "year_desc" ], "type": "string", "description": "How to order the listing feed before collecting.", "default": "newest" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of vehicle listings to collect.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. KB Chachacha serves listings without a bot wall, so the actor runs fine on a direct connection (default). If you ever see blocks at high volume, enable Apify Proxy here.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```