What is Encar API and how does it work?

The API connects you to Korea's largest car marketplace. Pull formatted car data through REST endpoints. Monitor new listings, price changes, and removals.

What Encar data does the scraper extract?

All car details: make, model, year, price, mileage, engine, transmission, VIN, diagnostic reports, accident history, seller info, photos, and modifications.

How often is Encar data updated?

Live data updates. New car listings detected within minutes. Daily files with all active and removed cars.

What formats does Encar API support?

Multiple formats: REST API for real-time data, JSON, CSV, and Excel. Each format contains complete vehicle information.

Can I access VIN numbers through the API?

Yes, VIN (Vehicle Identification Number) data is included when available in the listings. The API provides complete Korean car data including technical specifications and vehicle history.

How often are daily exports updated?

New files are generated every morning. They contain a complete snapshot of active listings and a list of vehicles removed the previous day.

Does the API cover vehicles beyond Korea?

Yes, Encar includes listings from all over Korea. Location data is provided for each listing to filter by region.

Encar APIScraper & Parser

Daily and Live exports of vehicle listings, prices, specs, diagnostics, accident history. Professional automotive data access.

Encar API

Access the entire Korean car market through one API. Clean, structured listing data for analytics and purchasing decisions. No need to build your own scraper.

API

Full access to all listing data via API endpoints, plus real-time monitoring for new, updated, and removed vehicles.

Daily Exports

Download complete market snapshots daily in CSV, JSON, or Excel formats.

Complete Data

Includes every available field: price, mileage, specs, photos, seller info, diagnostic reports, accident history, and all options.

Get API AccessAccess provided within 2 minutes

API

Base URL

https://{access_name}.auto-api.com/api/v2/encar

Authorization: api_key parameter

Workflow

/filtersretrieve all available filter options

/offersfetch vehicle listings with optional filters - ideal for initial data retrieval

To stay synchronized after initial load:

/change_id?date=...obtain the starting point for the changes stream

/changes?change_id=...retrieve all database modifications from a given ID

/offerfetch complete details for a specific vehicle by inner_id

Recommended integration approach:

1. Use /offers to retrieve the full initial dataset (paginate through all available pages)

2. After initial load, use /changes periodically to fetch incremental updates (additions/modifications/removals) and keep your local database in sync

3. For displaying data on your website, query /offers with specific filters and pagination (by brand, model, price range, year, etc.)

GET/filters

Returns all available filter options and their possible values

https://{access_name}.auto-api.com/api/v2/encar/filters?api_key=YOUR_API_KEY

Response:

{
  "mark": {
    "Hyundai": {
      "model": {
        "Sonata": {
          "configuration": {
            "DN8": { "complectation": ["Smart", "Modern", "Premium"] }
          }
        }
      }
    },
    "Kia": {
      "model": {
        "K5": {
          "configuration": {
            "DL3": { "complectation": ["LX", "EX", "SX"] }
          }
        }
      }
    }
  },
  "transmission_type": ["Manual", "Automatic", "Semi-Automatic", "CVT", "Other"],
  "color": ["White", "Black", "Silver", "Gray", "Blue", "Red", "Brown", "Beige", "Gold", "Green", "Yellow", "Orange", "Purple", "Pink", "Pearl", "Burgundy", "Turquoise", "Sky Blue", "Other"],
  "body_type": ["SUV", "Sedan", "Hatchback", "Minivan", "Pickup Truck", "Coupe/Roadster", "Microbus", "RV", "Other"],
  "engine_type": ["Gasoline", "Diesel", "Electric", "Hybrid (Gasoline)", "Hybrid (Diesel)", "Hydrogen", "LPG", "CNG", "Gasoline + LPG", "Gasoline + CNG", "LPG + Electric", "Other"]
}

GET/offers

Vehicle listings with pagination support and filtering capabilities

Parameters:

page (required) - page number
mark, model, configuration, complectation - filters (case-insensitive)
transmission_type, color, body_type, engine_type - filters (case-insensitive)
year_from, year_to - year range filter
km_age_from, km_age_to - mileage range filter
price_from, price_to - price range filter (in 10000 KRW units)

https://{access_name}.auto-api.com/api/v2/encar/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/encar/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=black

Response:

{
  "result": [
    {
      "id": 3219435,
      "inner_id": "40427050",
      "change_type": "added",
      "created_at": "2025-09-08T12:02:03.000Z",
      "data": {
        "id": 1454012,
        "inner_id": "40427050",
        "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=40427050",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "Diesel 2.2 4WD",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Prestige",
        "year": 2021,
        "color": "Black",
        "price": 3190,
        "price_won": "31900000",
        "km_age": 92842,
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "address": "Busan Gijang-gun",
        "seller_type": "DEALER",
        "is_dealer": true,
        "images": ["https://ci.encar.com/carpicture01/pic4041/40427050_001.jpg"],
        "extra": {"diagnosis": {...}, "inspection": {...}, "accidents": [...]}
      }
    }
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Data fields:

id - internal database ID
inner_id - listing ID on the platform
url - link to the listing
mark - car brand
model - car model
generation - generation
configuration - configuration
complectation - complectation/trim
year - production year
color - color
price - price in 10000 KRW units
price_won - full price in KRW
km_age - mileage in km
engine_type - engine type

transmission_type - transmission type
body_type - body type
address - address
seller_type - seller type
is_dealer - dealer flag (true/false)
section - section
seller - seller
salon_id - dealer ID
description - description
displacement - engine displacement (cc)
offer_created - listing creation date
images - array of image URLs
extra - additional data (JSON)
options - list of options

GET/change_id

Retrieve the first change ID for a specific date (to use with /changes)

Parameters:

date (required) - date in yyyy-mm-dd format

https://{access_name}.auto-api.com/api/v2/encar/change_id?api_key=YOUR_API_KEY&date=2025-01-15

Response:

{ "change_id": 8471926 }

Use the returned value as the change_id parameter in /changes

GET/changes

Real-time changes stream (new listings/price updates/removals)

Parameters:

change_id (required) - starting from which change ID

https://{access_name}.auto-api.com/api/v2/encar/changes?api_key=YOUR_API_KEY&change_id=1

Response:

{
  "result": [
    {
      "id": 456,
      "inner_id": "40427050",
      "change_type": "added",    // added - new listing
      "created_at": "2025-01-15T10:30:00Z",
      "data": { ... }            // full listing data
    },
    {
      "id": 457,
      "inner_id": "40427051",
      "change_type": "changed",  // changed - price update
      "created_at": "2025-01-15T10:31:00Z",
      "data": { "new_price": 3490, "new_price_won": 34900000 }
    },
    {
      "id": 458,
      "inner_id": "40427052",
      "change_type": "removed",  // removed - listing deleted
      "created_at": "2025-01-15T10:32:00Z"
    }
  ],
  "meta": { "cur_change_id": 1, "next_change_id": 21, "limit": 20 }
}

GET/offer

Complete details of a single vehicle listing by inner_id

Parameters:

inner_id (required)

https://{access_name}.auto-api.com/api/v2/encar/offer?api_key=YOUR_API_KEY&inner_id=40427050

Response: data object (identical structure to /offers items, without the result array wrapper)

Get Listing by URL

Retrieve complete listing data by providing the encar.com URL

Base URL

https://{access_name}.auto-api.com/api/v1/offer/info

Authorization: header x-api-key

POST/api/v1/offer/info

Get listing data from encar.com by URL

Parameters:

url (required) - link to the listing on encar.com

Request Example:

curl -L 'https://{access_name}.auto-api.com/api/v1/offer/info' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419" }'

Response:

{
  "inner_id": "39225419",
  "url": "http://www.encar.com/dc/dc_cardetailview.do?carid=39225419",
  "mark": "BMW",
  "model": "5-Series",
  "generation": "528i",
  "year": 2010,
  "year_month": "2010-08",
  "color": "Silver",
  "price": 880,
  "price_won": 8800000,
  "km_age": 132437,
  "engine_type": "Gasoline",
  "transmission_type": "Automatic",
  "body_type": "Sedan",
  "displacement": "2996",
  "power": "230",
  "vin": "WBAFR1105AC258998",
  "address": "Gwangju Seo-gu",
  "seller_type": "DEALER",
  "is_dealer": true,
  "offer_created": "2025-11-17",
  "images": [
    "https://ci.encar.com/carpicture02/pic3922/39225419_001.jpg",
    "https://ci.encar.com/carpicture02/pic3922/39225419_002.jpg"
  ]
}

Field Descriptions:

inner_id - listing ID on encar.com
url - link to the listing
mark - car brand
model - car model
generation - vehicle generation/trim
year - production year
year_month - production year and month (YYYY-MM)
color - vehicle color
price - price in units of 10,000 KRW
km_age - mileage in kilometers

engine_type - engine type
transmission_type - transmission type
body_type - body type
displacement - engine displacement (cc)
power - engine power (hp)
vin - vehicle identification number
address - seller location
seller_type - seller type
is_dealer - dealer flag
offer_created - listing creation date
images - array of image URLs

Daily Exports

Data Retention Policy

Files stored for 3+ days minimum

API Availability Schedule

Fresh daily files available for download

CSV Data Format

CSV files use pipe (|) as column separator

URL Structure:

https://{access_name}.auto-api.com/{date}/{file_name}

Request Parameters:

access_name - access_name - your assigned subdomain identifier
date - date - target date in yyyy-mm-dd format (e.g., 2025-09-06)
file_name - file_name - export file name with extension

Available Formats:

CSV - all_active.csv, new_daily.csv, removed_daily.csv
JSON - all_active.json, new_daily.json, removed_daily.json
Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

cURL API Request Example

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Wget Download Command

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'

Encar.com

Encar.com launched in 2001 and quickly became the go-to platform for buying and selling cars in South Korea. Today, you'll find around 240,000 cars listed there at any given moment, everything from tiny Kei cars popular in Seoul's narrow streets to imported BMWs and Mercedes. The site processes over 15 million searches monthly, making it Korea's largest automotive marketplace.

One thing that makes Encar different from typical classifieds: they actually verify cars. Sellers upload diagnostic reports (called "insurance history" in Korea), and many listings include professional inspection certificates that show everything from paint condition to undercarriage photos. Korean buyers won't even look at a car without these reports. The platform tracks accident history through government databases. If a car was damaged anywhere in Korea years ago, it shows up in the listing.

For anyone working with Korean vehicle data, Encar is the essential platform. The API provides this data continuously through organized endpoints, including vehicle specs, decoded option packages, VIN numbers, and clean datasets for analysis.

The Encar API runs 24/7, providing new listings within minutes of posting and tracking removals to understand actual selling prices versus asking prices. This crucial data is delivered through our API endpoints without the need for custom parsers or crawlers.

Other Automotive Data

Expand your automotive data coverage across global markets with our platform APIs:

🇨🇳

Che168 API

China automotive data API

🇨🇳

Dongchedi API

China automotive data API

🇨🇳

Guazi API

China automotive data API

🇦🇪