# Encar Scraper – Korea Used Car Prices, Mileage & Data (`claude_code_reviewer/encar-scraper-en`) Actor

Scrape Encar, Korea's largest used-car marketplace, without an API: maker, model, year, mileage, price (KRW), fuel, seller region and certification badges. Type makers in English or Korean, filter domestic/import, export JSON/CSV/Excel for market analysis and cross-border car sourcing.

- **URL**: https://apify.com/claude\_code\_reviewer/encar-scraper-en.md
- **Developed by:** [Chad](https://apify.com/claude_code_reviewer) (community)
- **Categories:** E-commerce, SEO tools, 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 car 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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

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

## How to integrate an Actor?

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

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

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

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

# README

## Encar Scraper | Korea Used Car Prices, Mileage, Maker & Data (no API)

Scrape **Encar**, Korea's largest used-car marketplace: maker, model, year, mileage, price (KRW), fuel type, seller region and Encar certification badges. Uses Encar's public JSON API — **no login, no API key, no token**. Type makers in English or Korean, or leave blank for the newest listings. Export clean snake\_case structured data (JSON / CSV / Excel).

Great for: cross-border dealer sourcing, Korea used-car market analysis, price comparison, import-car procurement intelligence, market monitoring.

***

### Output fields

| Field | Description |
|---|---|
| `car_id` | Car ID, primary key |
| `manufacturer` | Maker (Korean, e.g. 현대, 기아, BMW) |
| `origin` | `domestic` / `import` / `null` (uncatalogued maker) |
| `model` | Model, e.g. `올 뉴 K3` |
| `badge` | Trim / grade line, e.g. `프레스티지` |
| `fuel_type` | Fuel, e.g. `가솔린` (petrol), `디젤`, `LPG`, `전기` (EV) |
| `year` | Registration year (YYYY) |
| `year_month` | First-registration year+month (YYYYMM), e.g. `201804` |
| `mileage_km` | Mileage (km) |
| `price_manwon` | Price in 만원 (Encar's native 10,000-KRW unit) |
| `price_krw` | Price in KRW (= price\_manwon × 10000) |
| `sell_type` | Sale type, e.g. `일반` (normal), `리스` (lease), `렌트` (rent) |
| `region` | Seller region, e.g. `경기`, `부산` |
| `trust` | Warranty/service badge array, e.g. `["ExtendWarranty","HomeService"]` |
| `service_mark` | Encar service-mark array, e.g. `["EncarDiagnosisP1"]` |
| `condition` | Condition badge array, e.g. `["Inspection","Record","Resume"]` |
| `image_url` | First car photo |
| `image_count` | Number of photos |
| `url` | Vehicle detail page link |
| `source_mode` | Source mode |
| `source_query` | The maker keyword this row came from (blank = all makers) |
| `scraped_at` | Scrape time (ISO 8601) |

> Missing values are `null`; fields are never dropped. Prices reflect what Encar shows (excl. taxes/fees).

### Modes

| Mode | Description | Status |
|---|---|---|
| `search` | Maker → used-car listings | ✅ v1.0 |
| `detail` | Car ID → full spec, accident/seizure records, VIN, plate, all photos, seller contact | ✅ v1.1 |

#### Detail mode (v1.1)

Pass `mode: "detail"` + `carIds` (car IDs, usually the `car_id` from search output). Billed **$0.008** each, returning far more than the listing:

```json
{ "mode": "detail", "carIds": ["42063226", "41871403"] }
```

Extra fields: `vin`, `vehicle_no` (plate), `grade`/`grade_en`, `displacement_cc`, `transmission`, `color`, `seat_count`, `body_type`, `origin_price_manwon` (new-car price), `accident_record_available`/`resume_record_available`, `seizure_count`/`pledge_count` (0 = clean), `is_diagnosis_car`, `seller_type`/`seller_id`/`seller_address`/`seller_phone`, `view_count`/`subscribe_count`, `image_urls` (all photos), `option_codes`, `description`.

### Input parameters

| Parameter | Type | Description | Default |
|---|---|---|---|
| `keywords` | array | Maker (English or Korean, e.g. Hyundai/현대). Blank = newest listings | — |
| `carType` | select | all / domestic 국산 / import 수입 (only when maker is blank) | `all` |
| `bulkInput` | text | One maker per line, auto-merged | — |
| `maxItems` | integer | Cap **per maker** (1–500) | `50` |
| `proxyConfiguration` | proxy | No proxy by default; enable if blocked | off |

### Input examples

**1. Hyundai, first 10**

```json
{ "keywords": ["Hyundai"], "maxItems": 10 }
```

**2. Newest imported cars, 15**

```json
{ "carType": "import", "maxItems": 15 }
```

**3. Bulk multi-maker (Genesis / BMW / Tesla)**

```json
{ "bulkInput": "Genesis\nBMW\nTesla", "maxItems": 10 }
```

**4. Kia using the Korean maker name**

```json
{ "keywords": ["기아"], "maxItems": 20 }
```

### Notes

- **Makers accept English or Korean**: a built-in map resolves Hyundai↔현대, Benz↔벤츠, KGM↔KG모빌리티(쌍용), etc. Uncatalogued makers pass through verbatim (searched across all car types).
- **`carType` only applies when maker is blank**: when a maker is given, its car type is auto-detected (domestic makers search 국산, import makers 수입), so you never hit the empty "Hyundai + import" combination.
- **Price is in KRW**: `price_manwon` is Encar's native 만원 unit; `price_krw` is the KRW conversion for convenience.
- **`maxItems` is per maker**: 3 makers × 50 = up to 150 rows. A car appearing under two queries is output once.
- **Model filtering**: Encar's model field is an exact string (e.g. `올 뉴 K3`) and error-prone, so v1.0 omits it; planned for v1.1 alongside detail mode.
- **Listings are a snapshot**: the live Encar page is authoritative.

### FAQ

**Q: Do I need an Encar account or API key?**
No. Only public search results are scraped — no login or token required.

**Q: Can I scrape imported cars?**
Yes. Enter BMW, Benz, Audi, Tesla, etc. (English or Korean), or use `carType: "import"` for all imports.

**Q: What's the price unit?**
`price_krw` is Korean won (KRW). `price_manwon` keeps Encar's native 만원 unit.

**Q: Can I get full spec and accident history?**
Search mode returns structured listing fields; full spec, options and accident/service history ship in detail mode (v1.1).

**Q: How is it billed?**
Pay per event (PPE): $0.005 per run start + $0.002 per car. You are only charged after data is successfully stored.

### Disclaimer

This tool only scrapes publicly visible Encar used-car listings for market research and data analysis. Users must comply with Encar's terms of service and local law, and are responsible for how the data is used. This tool collects no private data that requires a login. Vehicle content and prices reflect what the site actually shows.

***

*Keywords: Encar scraper, Encar API, 엔카, Korea used cars, Korean used car data, used car price scraper, import car sourcing, car dealer tools, Korea car market, car price comparison, cross-border car dealer, used car data*

# Actor input Schema

## `mode` (type: `string`):

Search listing (maker → list) or detail (car ID → full spec, accident/seizure records, seller contact).

## `carIds` (type: `array`):

For detail mode: a list of car IDs (the car\_id from search output). Billed $0.008 each; returns full spec, accident/seizure records, VIN, plate, all photos, seller contact and description. You can also paste one ID per line in Bulk paste below.

## `keywords` (type: `array`):

Car maker keywords, English or Korean, e.g. Hyundai, Kia, Genesis, BMW, Benz, Tesla, or 현대, 기아. Leave blank for the newest listings across all makers (no filter). Built-in English↔Korean map; model filtering (e.g. K5) is planned for v1.1.

## `carType` (type: `string`):

Only applies when maker is blank (a maker implies its own car type).

## `bulkInput` (type: `string`):

**One per line** (Enter for a new line, no quotes/commas). Search mode merges into makers; detail mode merges into car IDs.

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

Max items **per maker** (or for the whole unfiltered search). Higher means higher cost.

## `proxyConfiguration` (type: `object`):

Encar's search API is friendly to datacenter requests; the default runs with no proxy. Only enable it if you hit blocks at scale.

## Actor input object example

```json
{
  "mode": "search",
  "keywords": [
    "Hyundai"
  ],
  "carType": "all",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# 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 = {
    "mode": "search",
    "keywords": [
        "Hyundai"
    ],
    "carType": "all"
};

// Run the Actor and wait for it to finish
const run = await client.actor("claude_code_reviewer/encar-scraper-en").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 = {
    "mode": "search",
    "keywords": ["Hyundai"],
    "carType": "all",
}

# Run the Actor and wait for it to finish
run = client.actor("claude_code_reviewer/encar-scraper-en").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 '{
  "mode": "search",
  "keywords": [
    "Hyundai"
  ],
  "carType": "all"
}' |
apify call claude_code_reviewer/encar-scraper-en --silent --output-dataset

```

## MCP server setup

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

```

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/AYm8gGKkkzw58vjPY/builds/rlvCosgfuKc6WPhvS/openapi.json