Rinevo
Rinevo
Rinevo Developer DocumentationREST v2.0 Production Contract

Automotive Data API Documentation

Complete developer reference and REST endpoint specifications for querying 378,000+ verified vehicles across South Korea (Encar.com) and Japan (Goo-net JDM).

Get API Key (€0 Due Today)South Korea Encar APIJapan Goo-net JDM APIDealership Bots
Authentication

API Key Header

Pass your private key in the x-api-key: YOUR_API_KEY header or as a standard Authorization: Bearer YOUR_API_KEY token.

Market Scope

Dual-Market Selection

Filter by market using ?source=encar (South Korea) or ?source=goonet (Japan). If omitted, queries default strictly to your account-entitled markets.

Production Edge

Base Gateway URL

Production REST queries target https://api.rinevoapi.com with sub-120ms median latency and gzip/brotli compression.

API Reference Matrix

Canonical Production Endpoints

GET

/api/v2/cars

Catalog Search & Filtering

Primary search endpoint querying active inventory across South Korea (140,000+ Encar listings) and Japan (285,000+ Goo-net listings). Supports filtering by manufacturer brand, model, manufacturing year range, transmission, fuel type, price, and pagination.

Parameters:
  • source (string, optional): Market source (encar or goonet).
  • brand (string, optional): Manufacturer (e.g., Hyundai, Genesis, Toyota, Nissan).
  • model (string, optional): Model family (e.g., Grandeur, G80, Crown, Skyline).
  • minYear / maxYear (integer, optional): Registration year bounds.
  • limit / page (integer, optional): Pagination limits (default limit: 20).
GET

/api/v2/vehicle/:id

Vehicle Profile & 17-Digit VIN

Extracts the complete vehicle forensic profile by marketplace ID (Encar 8-digit numeric ID or Goo-net listing identifier). Delivers unmasked 17-digit ISO-3779 chassis VIN, engine displacement in cc, multi-currency valuation (KRW/JPY/USD/EUR), color codes, and high-resolution CDN photo galleries.

GET

/api/v2/vin/:vin

Chassis VIN Timeline & Fraud Check

Chronological vehicle history tracking past price drops, re-listings across dealerships, export milestones, and odometer rollback anomalies across Korean and Japanese registries.

GET

/api/v1/vehicle-condition/:carId

68-Point Mechanical Inspection & KIDI

Standardized parsing of official South Korean MOLIT mechanical inspection certificates: structural frame damage, outer panel replacements, fluid leaks, and official KIDI CarHistory insurance payout records.

GET

/api/v1/options/:carId

54 Bilingual Translated Options

Normalized equipment options mapped from native Korean to standardized English (e.g. panoramic sunroof, head-up display, adaptive cruise control) with original Korean character strings retained for customs clearance audits.

GET

/api/v1/integrations/bot/search

Dealership Bot Gateway

Lightweight high-speed search endpoint formatted specifically for automotive dealership chatbots on WhatsApp, Telegram, Viber, and Instagram. Automatically applies your server-side dealer margin markup before outputting buyer-facing rich media cards.

Learn more about Automotive Dealership Bots →
Live Interactive Console

Interactive API Sandbox & Code Generator

Test live JSON responses in your browser and generate copy-pasteable snippets in cURL, Python, Node.js, and Go.

Active Production Database|100k+ Certified Korean Vehicles
Base URL:https://api.rinevoapi.com

API Documentation & Reference

Welcome to the official developer reference. Our active production database is 100% populated with 100k+ certified Korean vehicles (Encar) featuring 100% unmasked 17-digit VINs, 68-point diagnostic sheets, official KIDI insurance claims, and 54 bilingual options. For Japan (Goo-net), on-demand web scraping is available on request.

Live Vehicles in DB100k+100% Encar Korea
Chassis VIN Resolution100.0%100k+ Unmasked VINs
68-Pt Diagnostics100.0%Inspection Sheets in DB
KIDI Insurance Ledger100.0%Claims, Payouts & Floods
Quickstart in 30 Seconds

Authenticate requests with your API key in the x-api-key header. Edge Security Note: Always include a User-Agent header (e.g. RinevoClient/1.0) to prevent edge firewall filtering.

curl -X GET "https://api.rinevoapi.com/api/v2/vehicle/42830806" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "User-Agent: RinevoClient/1.0" \
  -H "Accept: application/json"

Select an Endpoint to Inspect

Review parameters, request schemas, and live forensic structures.

GET/api/v2/vehicle/:id

Pulls the complete vehicle profile: verified 17-digit chassis VIN, 68-point diagnostic sheet, official KIDI insurance claims, 54 bilingual options, multi-currency valuation, and high-resolution CDN photos.

Try in Playground
Request Parameters
ParameterTypeInRequiredDescription
idstringpathREQUIREDEncar vehicle listing ID (e.g. 42830806) or Goo-net listing identifierExample: 42830806

HTTP Response Status Codes & Error Handling

All error payloads return JSON with a descriptive error message and code.

Status CodeMeaningDescription & Suggested Action
200 OKSuccessful QueryRequest succeeded. The requested vehicle object, search catalog results, or decoded VIN timeline is returned in the payload.
400 Bad RequestInvalid Parameter FormatSupplied query parameter is invalid (e.g. limit out of range 1-50, or malformed chassis VIN length).
401 UnauthorizedMissing or Invalid API KeyThe x-api-key header was not provided or failed cryptographic verification. Check your developer dashboard key.
403 ForbiddenQuota Limit or Origin RestrictedMonthly request quota depleted, plan inactive, or caller domain is not whitelisted in your Allowed CORS Domains list.
404 Not FoundVehicle Not in Active CatalogVehicle listing ID or VIN does not exist in the active 100k+ database. Verify the listing number on Encar.
429 Too Many RequestsRate Limit ThrottledExceeded tier burst limit (e.g., >10 req/sec on Sandbox). Inspect the Retry-After header and throttle worker threads.

Required HTTP Request Headers

1. Authenticationx-api-key: YOUR_API_KEY

Pass in header or as Bearer token.

2. Edge Signature (Mandatory)User-Agent: YourApp/1.0

Required to prevent Cloudflare edge blocking.

3. Content NegotiationAccept: application/json

Returns UTF-8 normalized JSON.

Market Status: South Korea (Encar) is our active production REST API with 100k+ certified vehicles. For Japan (Goo-net), dedicated on-demand web scraping pipelines are available upon request.
Return Home