Developer Hub

Encar Market Data API Guide

Integrate lightning-fast, high-precision South Korean used car data directly into your custom website, CRM, dealer system, or stock manager. Every endpoint translates options check-lists and accident history logs into structured English automatically.

Client Integration Quick-Start

1. Authentication Header

To make requests to our API endpoints, you must include your private client API key in the headers of your request using the key name x-api-key.

headers: {
  "x-api-key": "YOUR_RIN_API_KEY_HERE"
}

2. Allowed Origins & CORS Locking

For security, API keys are locked using **Domain Locking (CORS)**. The backend blocks calls originating from unauthorized websites.

Network Fetch Error / CORS Issues?

If your frontend app gets a NetworkError when attempting to fetch resource, ensure:

Your website domain (e.g. https://yourdomain.com) is whitelisted in your API Key settings.
When testing locally, add http://localhost:3000 or http://localhost:3001 to your allowed origins.
Or route requests through your own backend (server-to-server) to avoid exposing your API key and bypass browser CORS limitations.

API Base Host

https://api.rinevoapi.autos

Integration Strategy

Server-to-Server (Recommended): Make requests from your Node.js, Python, or PHP backend. This hides your private API key from public view and avoids CORS checks entirely.

Rate Limits

Responses return standard rate limiting headers to check allocation: X-RateLimit-Limit and X-RateLimit-Remaining.

API Endpoints

Query Parameters

:carId

Encar vehicle numeric identifier

Required

apiKey

Alternative auth string parameter

Optional

Request Snippet

curl -X GET "https://api.rinevoapi.autos/api/scraper/cars?brand=Hyundai&model=Tucson&priceMax=35000000" \
  -H "x-api-key: YOUR_API_KEY"

Response Payload (JSON)

200 OK

{
  "success": true,
  "data": {
    "cars": [
      {
        "id": "42047351",
        "encar_id": "42047351",
        "title": "Hyundai Tucson 1.6 Premium",
        "brand": "Hyundai",
        "model": "Tucson",
        "year": 2023,
        "price": 28500000,
        "currency": "KRW",
        "mileage": 18240,
        "fuelType": "Gasoline",
        "transmission": "Automatic",
        "color": "White",
        "type": "SUV",
        "image": "https://ci.encar.com/carpicture/...",
        "images": [
          "https://ci.encar.com/carpicture/1.jpg"
        ],
        "prices": {
          "EUR": 19655,
          "USD": 21111,
          "KRW": 28500000
        },
        "vin": "204저1294",
        "scraped_at": "2026-06-01T14:35:44.800Z",
        "updated_at": "2026-06-01T14:35:44.800Z"
      }
    ],
    "pagination": {
      "total": 126641,
      "page": 1,
      "limit": 10,
      "hasNext": true,
      "hasPrev": false
    }
  }
}

Need Custom Schema Integrations?

We offer personalized API solutions, custom webhook notifications, bulk database exports, and dedicated high-performance routing pipelines for enterprises and high-volume dealerships.

Contact Enterprise Sales