API Reference

Documentation

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

Industry Experience

Automotive data API provider with years of experience in the Korean market.

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.

Real-Time Listing Alerts

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

CSV downloads

Download make, model and badge lists as CSV - cache them and skip live facet calls.

Flexible Export Formats

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

Base URL

All API requests are made to the following base URL:

url

https://api.encarapi.com

For example, to fetch offers:

http

GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true

Interactive API reference OpenAPI spec

Authentication

Authenticate your requests using an API key. Pass it as a query parameter or via the Authorization header.

bash

# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"

# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY

Integration Workflow

Follow these four steps to integrate with the EnCarAPI.

Get Available Filters

Retrieve all possible filter values (marks, models, configurations, colors, etc.)

GET /filters

Get Vehicle Listings

Fetch paginated listings with optional filters for make, model, year, price, and more.

GET /offers?page=1

Track Changes

Get a change ID for a date, then poll for added, changed, and removed listings.

GET /change_id → GET /changes

Get Listing Details

Fetch full details for a specific listing by its inner_id.

GET /offer?inner_id=...

API Endpoints

All available endpoints for accessing Korean vehicle data.

Dropdown data (CSV)

Download the make, model and badge lists as CSV, cache them, and build your dropdowns from them - no per-click facet calls and no offline mapping. Each file includes a count column, and the badge file carries the body-style split (Coupe / Sedan / Cabrio).

Download once, cache it - Updated daily

https://api.encarapi.com/api/taxonomy/makes.csv?api_key=YOUR_KEY

All makes with listing counts

https://api.encarapi.com/api/taxonomy/models.csv?api_key=YOUR_KEY

All make and model combinations with counts

https://api.encarapi.com/api/taxonomy/badges.csv?api_key=YOUR_KEY

All make, model and badge values (incl. Coupe / Sedan / Cabrio) with counts

Add your API key to download - append ?api_key=YOUR_KEY to any file URL. The files are key-protected, so nobody can download them without a valid key.

Data freshness

The full catalog is refreshed every day, the newest listings are picked up every 2 hours, and sold cars are removed hourly.

How long to cache

Filter values, taxonomy CSVs and /api/nav: cache for 24 hours
Vehicle listings (/api/catalog): cache for 1 to 2 hours
Vehicle details (/api/vehicle/:id): cache for 24 hours

Serve listings from your own database and refresh on this cadence rather than calling live on every user click.

Frequently Asked Questions

Ready to Get Started?

Contact on Telegram