Car Listings API for Encar, Mobile.de, Che168, Dongchedi & More
Access to aggregated car listing data via a single, reliable API. Monitor new listings, price changes, publication, and removals in real time across platforms.
Base URL
https://{access_name}.auto-api.com/api/v2/{encar|che168|dongchedi|...}Authorization: api_key parameter
Workflow
/filtersget available filter values/offersget listings (with or without filters) - use for initial data loadFor updates (to keep data up-to-date after initial load):
/change_id?date=...get starting ID for changes feed/changes?change_id=...get all changes in the database starting from ID/offerget details of a specific listing by inner_idRecommended integration approach:
1. First, use /offers for initial data retrieval (iterate through all pages)
2. Then, use /changes for periodic retrieval of all changes (added/modified/removed) to sync your local database with the source
3. For website data integration, you can use /offers with filters and pagination (brand, model, price, year, etc.)
GET/filters
Returns all possible values for filtering
https://{access_name}.auto-api.com/api/v2/{platform}/filters?api_key=YOUR_API_KEYResponse:
{
"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
List of listings with pagination and filters
Parameters:
page(required) - page numbermark, model, configuration, complectation- filters (case-insensitive)transmission_type, color, body_type, engine_type- filters (case-insensitive)year_from, year_to- year range filterkm_age_from, km_age_to- mileage range filterprice_from, price_to- price range filter (in 10000 KRW units)
https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/{platform}/offers?api_key=YOUR_API_KEY&page=1&mark=Hyundai&color=blackResponse:
{
"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
Get first change ID by date (for use in /changes)
Parameters:
date(required) - date in yyyy-mm-dd format
https://{access_name}.auto-api.com/api/v2/{platform}/change_id?api_key=YOUR_API_KEY&date=2025-01-15Response:
{ "change_id": 1547283 }Use the returned value as the change_id parameter in /changes
GET/changes
Changes feed (added/changed/removed)
Parameters:
change_id(required) - starting from which change ID
https://{access_name}.auto-api.com/api/v2/{platform}/changes?api_key=YOUR_API_KEY&change_id=1Response:
{
"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 }
},
{
"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
Single listing by inner_id
Parameters:
inner_id(required)
https://{access_name}.auto-api.com/api/v2/{platform}/offer?api_key=YOUR_API_KEY&inner_id=40427050Response: data object (same as in /offers, but without result wrapper)
Retrieve complete listing data by providing the original URL from any supported platform. Ideal for quick lookups and single listing retrieval.
Base URL
https://{access_name}.auto-api.com/api/v1/offer/infoAuthorization via x-api-key header
POST/api/v1/offer/info
Send a POST request with the listing URL to get complete data
Parameters:
url(required) - link to the listing on any supported platform
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"
]
}Data fields:
- inner_id - listing ID on the platform
- url - link to the listing
- mark - car brand
- model - car model
- generation - generation
- year - production year
- year_month - production year and month
- color - color
- price - price in 10000 KRW units
- km_age - mileage in km
- engine_type - engine type
- transmission_type - transmission type
- body_type - body type
- displacement - engine displacement (cc)
- power - power in hp
- vin - VIN code
- address - address
- seller_type - seller type
- is_dealer - dealer flag (true/false)
- offer_created - listing creation date
- images - array of image URLs
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:
Request Parameters:
access_name- your assigned subdomain identifierdate- target date in yyyy-mm-dd format (e.g., 2025-09-06)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.csvWget Download Command
wget --method GET \
--header 'Authorization: Basic XXX==' \
'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'Multi-Platform Data
Pull car listings from Encar, Mobile.de, AutoScout24, and more through one API.
Real-time Updates
Get new listings, price changes, and removals as they happen.
Market Analytics
Historical data and trends for pricing analysis and market research.
Flexible Delivery
Choose between real-time API access or daily bulk exports in CSV, JSON, Excel.
Global Markets
Coverage across Europe, Asia, Middle East, and North America.
Simple Integration
RESTful API with documentation and working code examples.