Metadata-Version: 2.2
Name: koreancar
Version: 2.0.2
Summary: A Python library for fetching vehicle data from Encar.com.
Home-page: https://github.com/markolofsen/koreancar
Author: Unrealos
Author-email: m@unrealos.com
License: MIT
Project-URL: Documentation, https://github.com/markolofsen/koreancar
Project-URL: Source, https://github.com/markolofsen/koreancar
Project-URL: Company, https://unrealos.com
Keywords: koreancar,encar,vehicle-data,API,python-library
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.1
Requires-Dist: urllib3>=1.26.5
Provides-Extra: testing
Requires-Dist: pytest>=6.0; extra == "testing"
Requires-Dist: pytest-cov; extra == "testing"
Requires-Dist: tox; extra == "testing"

# Koreancar API: Automotive Data Integration for Car Listings & Vehicle Insights

**Koreancar API** is a powerful **automotive data API** designed for seamless integration with **[Encar.com](https://www.encar.com)**, Korea's leading vehicle marketplace. Developed by **[Unrealos](https://unrealos.com)**, our API provides structured access to real-time **car listings**, **vehicle specifications**, **historical vehicle data**, and **automotive analytics**—making it an essential tool for **car dealerships**, **automotive marketplaces**, **car inventory management systems**, and **developers** building **car-related SaaS solutions**.

---

## Key Features

- **Real-Time Car Listings API**: Fetch up-to-date **Korean used cars** with details like **price**, **mileage**, **year**, and **model**.
- **Comprehensive Vehicle Data API**: Access **VIN-based vehicle history**, **accident records**, **performance inspections**, and **extended warranty options**.
- **Automotive Data API for Developers**: Use our **structured JSON API** to integrate **car database services** into web & mobile applications.
- **OpenAPI 3.0 Standard**: Our API is **well-documented** and supports **automated integration**.
- **Scalable and Reliable**: Ideal for **large-scale automotive data processing**, supporting **car marketplaces**, **SEO car content optimization**, and **AI-driven car analytics**.

---

## Try the Koreancar API

Access the **Koreancar API** here:

👉 **[carsapi.unrealos.com](https://carsapi.unrealos.com/)**

Our API is built on the **OpenAPI 3.0 framework**, making it easy to **test, explore, and integrate** into your platform.

---

## API Endpoints & Example Response

### **Example: Car Listing & Vehicle Details**

```json
{
  "id": "b1ab8841-446d-4989-b600-fb4d1bf1595f",
  "vehicle_id": "38781891",
  "model_name": "G80 (RG3)",
  "year": "2021",
  "price": 5291,
  "main_data": {
    "category": {
      "manufacturerName": "Genesis",
      "modelName": "G80 (RG3)",
      "gradeName": "Gasoline 2.5 Turbo 2WD",
      "yearMonth": "202009",
      "originPrice": 5291
    },
    "spec": {
      "mileage": 71871,
      "displacement": 2497,
      "fuelName": "Gasoline",
      "colorName": "Silver Gray",
      "seatCount": 5,
      "transmission": "Automatic"
    },
    "advertisement": {
      "price": 3580,
      "status": "ADVERTISE",
      "trust": ["Meetgo", "HomeService", "ExtendWarranty", "Warranty"],
      "highlight": "Certified dealer listing with nationwide delivery. Accident-free, rare matte color."
    },
    "history": {
      "accidents": 1,
      "previousOwners": 0,
      "loanStatus": 1,
      "firstRegistrationDate": "2020-09-08",
      "accidentDetails": [
        { "cost": 590547, "description": "Minor front-end collision" },
        { "cost": 2917739, "description": "Rear-end damage, fully repaired" }
      ]
    }
  }
}
```

---

## Use Cases

- **Used Car Listings API** – Power your platform with dynamic, real-time **Korean car listings**.
- **Automotive Marketplaces** – Get structured data for **SEO-friendly car websites** & marketplace apps.
- **Car Dealership Software** – Automate **inventory tracking**, **vehicle history checks**, and **car pricing analysis**.
- **Fleet Management & Car Rental APIs** – Integrate **vehicle specs** & **ownership history** into your platform.
- **AI Automotive Solutions** – Leverage our **vehicle database API** for **machine learning**, **predictive car pricing**, and **automated car valuation tools**.

---

## Get Started

1. **Test the API**: Visit **[carsapi.unrealos.com](https://carsapi.unrealos.com/)** to explore our **Korean vehicle API** documentation.
2. **Integrate Seamlessly**: Use our **real-time car database API** for your **automotive software**.
3. **Contact Us**: For **API access, pricing, partnerships**, or **custom vehicle data solutions**, reach out via our contact form:

👉 **[unrealos.com](https://unrealos.com/)**

---

## About Unrealos

**[Unrealos](https://unrealos.com)** is a leader in **AI-driven SaaS, automotive data APIs, and digital business automation**. Our Koreancar API is designed to **empower automotive businesses** by providing **high-quality vehicle data** for **dealerships, marketplaces, and developers**.

🚀 **Start integrating automotive data today with Koreancar API!**
