DocumentationAPI Reference

Automotive Scraper API documentation. Learn how to access car data via direct API endpoints. Integration guides and code examples.

Clean, structured automotive data delivered through API. No complex setup, infrastructure management, or technical maintenance needed.

Why Choose Us

Industry Experience

Automotive data API provider with over 8 years of experience since 2017.

7-Day Support

Support team available 7 days a week for API integration help.

24/7 Service

Round-the-clock monitoring for reliable data delivery.

Key API Capabilities | Scrapers & Parsers

Real-Time Listing Alerts

Get instant API access to new car listings as they're posted.

Daily Data Exports

Get daily exports of active and removed listings for market analysis and sales tracking.

Flexible Export Formats

Get data in CSV, JSON, Excel, and custom formats for easy integration.

Frequently Asked Questions | API vs Scraper & Crawler

How does the automotive API work?

Automotive API provides real-time access to data from major car marketplaces. Delivers formatted data through REST API.

What data does the automotive API provide?

Full car data including specs, pricing, seller info, location, and mileage. Access millions of listings from major platforms through API calls.

Are there usage limits?

No usage limits. Get all active listings across regions via real-time API or daily exports. No restrictions for business partners.

How can I track new car listings with the real-time API?

Monitor listings using 'change_id' parameter. Begin with change_id=0, then use last change ID + 1. Captures new listings, price changes, removals across platforms.

Which data formats do you support?

Get data in CSV, JSON, Excel, and database formats. Each format provides comprehensive data from all platforms.

Can you build custom API access for a specific marketplace?

Yes, we build custom API solutions for any car marketplace. Contact us with your requirements.

Is my data usage kept confidential?

Yes. We work under strict confidentiality agreements with all clients. Your use of our services stays private and secure.

Do I need to manage infrastructure or servers?

No, it's fully managed. We handle all infrastructure, servers and data collection. You get ready-to-use data.

API Reference

Base URL

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

Authorization: api_key parameter

Workflow

1
/filtersget available filter values
2
/offersget listings (with or without filters) - use for initial data load
3

For 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
4
/offerget details of a specific listing by inner_id

Recommended 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_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

List of listings with pagination and filters

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/{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=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

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-15

Response:

{ "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=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 }
    },
    {
      "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=40427050

Response: data object (same as in /offers, but without result wrapper)

Get Listing by URL

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/info

Authorization 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
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 - your assigned subdomain identifier
  • date - 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.csv

Wget Download Command

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