# Encar Listings Scraper (`piotrv1001/encar-listings-scraper`) Actor

The Encar Listings Scraper extracts car listings from Encar.com, South Korea's largest used-car marketplace, capturing make, model, trim, year, mileage, price, fuel type, transmission, dealer, region, and photos — ideal for price analysis, market research, and vehicle sourcing.

- **URL**: https://apify.com/piotrv1001/encar-listings-scraper.md
- **Developed by:** [FalconScrape](https://apify.com/piotrv1001) (community)
- **Categories:** Automation, Developer tools, E-commerce
- **Stats:** 18 total users, 7 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 car listings

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

### 🚗 Encar Listings Scraper

Extract **used-car listings from [Encar](https://www.encar.com)**, South Korea's largest used-car marketplace. The **Encar Listings Scraper** turns Encar's 200,000+ live listings into clean, structured data — perfect for price analysis, market research, dealer monitoring, and vehicle sourcing.

Run it on demand or on a schedule, pull results through the Apify API, and export to JSON, CSV, Excel, or integrate with Make, Zapier, Google Sheets, and more.

### ✨ Features

- 🏷️ **Rich listing data** — make, model, trim, year, mileage, price (KRW), fuel type, transmission, region, dealer, and photo URLs.
- 🌐 **Domestic & imported** — scrape Korean-brand cars, imported cars, or both.
- 💰 **Price filtering** — narrow results to a price range so you only pay for the cars you care about.
- 🔎 **Optional full vehicle details** — flip one switch to enrich each car with VIN, plate number, English make/model names, original MSRP, color, engine displacement, seat count, body type, option count, seller contact, view count, and more.
- 📷 **Full-resolution images** — direct photo URLs for every listing.
- ⚡ **Fast & reliable** — pulls structured data straight from the source, no flaky page parsing.

### 🛠️ How It Works

1. **Choose what to scrape** — pick domestic, imported, or all cars, and optionally set a price range.
2. **Set a limit** — choose how many cars to collect (`maxItems`).
3. **(Optional) Enable full details** — turn on `Scrape full vehicle details` for VIN-level data per car.
4. **Run the scraper** — start the run and receive clean, structured data you can download or pipe into your tools.

### ⚙️ Input

| Field | Type | Description |
|-------|------|-------------|
| `carType` | select | `domestic`, `imported`, or `all`. Default: `domestic`. |
| `priceMin` | integer | Minimum price in units of 10,000 KRW (만원). Optional. |
| `priceMax` | integer | Maximum price in units of 10,000 KRW (만원). Optional. |
| `scrapeDetails` | boolean | Fetch the full detail record for each car. Default: `false`. |
| `maxItems` | integer | Maximum number of cars to scrape. Default: `50`. |
| `proxyConfiguration` | object | Optional proxy settings. |

#### Example input

```json
{
    "carType": "domestic",
    "priceMin": 1000,
    "priceMax": 3000,
    "scrapeDetails": false,
    "maxItems": 50
}
````

### 📊 Sample Output Data

The scraper returns structured JSON. You can download the dataset in JSON, CSV, Excel, or HTML.

**Listing item** (`scrapeDetails: false`):

```json
{
    "id": "41980227",
    "url": "https://fem.encar.com/cars/detail/41980227",
    "manufacturer": "르노코리아(삼성)",
    "model": "SM6",
    "badge": "2.0 GDe RE",
    "transmission": "오토",
    "fuelType": "가솔린",
    "year": 201605,
    "formYear": "2016",
    "mileage": 41912,
    "price": 8700000,
    "priceManwon": 870,
    "region": "경기",
    "officeName": "(주)우리들모터스",
    "dealerName": "백승구",
    "modifiedDate": "2026-06-09 15:52:11.000 +09",
    "mainPhotoUrl": "https://imgcar.encar.com/carpicture07/pic4197/41972384_001.jpg",
    "photoUrls": ["https://imgcar.encar.com/carpicture07/pic4197/41972384_001.jpg"]
}
```

**With full details** (`scrapeDetails: true`) adds fields such as:

```json
{
    "vin": "W1NFF2DE6LA286132",
    "plateNumber": "368무7575",
    "manufacturerEnglish": "Mercedes-Benz",
    "modelGroupEnglish": "GLS-Class",
    "gradeEnglish": "GLS400d 4MATIC",
    "originPrice": 138100000,
    "color": "흰색",
    "bodyType": "SUV",
    "seatCount": 7,
    "displacement": 2925,
    "viewCount": 884,
    "optionCount": 56,
    "sellerAddress": "서울 강남구 헌릉로745길 37"
}
```

### 🧾 Output Fields

| Field | Description |
|-------|-------------|
| `id` | Encar listing ID |
| `url` | Link to the car's detail page |
| `manufacturer` / `model` / `badge` | Make, model, and trim (Korean) |
| `year` / `formYear` | Registration year-month and model year |
| `mileage` | Odometer reading in km |
| `price` | Price in KRW (`priceManwon` is the 만원 value) |
| `fuelType` / `transmission` | Powertrain details |
| `region` / `officeName` / `dealerName` | Seller location and dealer |
| `mainPhotoUrl` / `photoUrls` | Listing images |
| `vin` / `plateNumber` | *Details mode* — VIN and plate number |
| `manufacturerEnglish` / `modelGroupEnglish` / `gradeEnglish` | *Details mode* — English names |
| `originPrice` | *Details mode* — original MSRP in KRW |
| `color` / `bodyType` / `seatCount` / `displacement` | *Details mode* — specs |
| `viewCount` / `optionCount` / `sellerAddress` | *Details mode* — extra metadata |

### 💵 Pricing

This Actor uses the **pay-per-result** model — you pay only for the data you get, with **no monthly rental and no per-run start fee**:

- **$0.005 per car listing** (`product-listing`)
- **$0.02 per full vehicle detail record** (`item-detail`, only when `Scrape full vehicle details` is enabled)

**Examples:**

- 1,000 listings → **$5**
- 10,000 listings → **$50**
- 1,000 cars with full details → **$5 + $20 = $25**

With a generous Apify free tier, you can try the Actor and pull your first results at no cost.

### 💡 Tips

- Start with a small `maxItems` (e.g. 10) to preview the data structure before a large run.
- Leave `scrapeDetails` off when you only need listing-level data — it's faster and cheaper.
- Use `priceMin` / `priceMax` to focus on a segment (e.g. budget cars or premium imports).
- Schedule the Actor to track new listings and price changes over time (`modifiedDate` reflects the latest update).

### ❓ FAQ

**Is scraping Encar legal?**
This Actor collects publicly available listing data. You are responsible for how you use the data and for complying with Encar's Terms of Service and applicable laws. Avoid collecting personal data you are not permitted to use.

**Why is the data in Korean?**
Listing-level make/model and option values are in Korean, as shown on Encar. Enable `Scrape full vehicle details` to also get English make/model/grade names.

**Can I get the VIN and plate number?**
Yes — enable `Scrape full vehicle details`.

**How many cars can I scrape?**
Encar has 200,000+ live listings. Set `maxItems` as high as you need.

### 📨 Support

Found a bug or need a new field? Open an issue on the Actor's **Issues** tab. Custom scraping solutions are available on request.

Start sourcing Korean used-car data with the **Encar Listings Scraper** today! 🚗

# Actor input Schema

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

Which part of the inventory to scrape: Korean domestic cars, imported cars, or both.

## `priceMin` (type: `integer`):

Only include cars priced at or above this value. Prices are in units of 10,000 KRW (만원). For example, 2000 means 20,000,000 KRW. Leave empty for no lower limit.

## `priceMax` (type: `integer`):

Only include cars priced at or below this value. Prices are in units of 10,000 KRW (만원). For example, 5000 means 50,000,000 KRW. Leave empty for no upper limit.

## `scrapeDetails` (type: `boolean`):

Fetch the full detail record for each car (VIN, plate number, English names, MSRP, color, displacement, options, view count, and more). This makes one extra request per car, so runs are slower and cost more.

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

Maximum number of car listings to scrape. Use a low number for testing.

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

Proxy settings. The default works well; enable Apify Proxy only if you run into rate limiting at large scale.

## Actor input object example

```json
{
  "carType": "domestic",
  "scrapeDetails": false,
  "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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("piotrv1001/encar-listings-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("piotrv1001/encar-listings-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 piotrv1001/encar-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=piotrv1001/encar-listings-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Encar Listings Scraper",
        "description": "The Encar Listings Scraper extracts car listings from Encar.com, South Korea's largest used-car marketplace, capturing make, model, trim, year, mileage, price, fuel type, transmission, dealer, region, and photos — ideal for price analysis, market research, and vehicle sourcing.",
        "version": "0.0",
        "x-build-id": "N7n4JXSs5g56JPlQh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/piotrv1001~encar-listings-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-piotrv1001-encar-listings-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/piotrv1001~encar-listings-scraper/runs": {
            "post": {
                "operationId": "runs-sync-piotrv1001-encar-listings-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/piotrv1001~encar-listings-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-piotrv1001-encar-listings-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": {
                    "carType": {
                        "title": "Car type",
                        "enum": [
                            "domestic",
                            "imported",
                            "all"
                        ],
                        "type": "string",
                        "description": "Which part of the inventory to scrape: Korean domestic cars, imported cars, or both.",
                        "default": "domestic"
                    },
                    "priceMin": {
                        "title": "Minimum price (in 10,000 KRW / 만원)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include cars priced at or above this value. Prices are in units of 10,000 KRW (만원). For example, 2000 means 20,000,000 KRW. Leave empty for no lower limit."
                    },
                    "priceMax": {
                        "title": "Maximum price (in 10,000 KRW / 만원)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Only include cars priced at or below this value. Prices are in units of 10,000 KRW (만원). For example, 5000 means 50,000,000 KRW. Leave empty for no upper limit."
                    },
                    "scrapeDetails": {
                        "title": "Scrape full vehicle details",
                        "type": "boolean",
                        "description": "Fetch the full detail record for each car (VIN, plate number, English names, MSRP, color, displacement, options, view count, and more). This makes one extra request per car, so runs are slower and cost more.",
                        "default": false
                    },
                    "maxItems": {
                        "title": "Maximum number of cars",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of car listings to scrape. Use a low number for testing.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. The default works well; enable Apify Proxy only if you run into rate limiting at large scale.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```