Metadata-Version: 2.2
Name: koreancar
Version: 2.0.1
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: Comprehensive Access to Korean Car Market Data

**Koreancar API** provides structured and up-to-date automotive data from [Encar.com](https://www.encar.com), Korea’s leading vehicle marketplace. Designed for developers, dealerships, and analytics platforms, our API delivers real-time access to car listings, vehicle details, and related market insights.

🚀 **Explore the API now:** [carsapi.unrealos.com](https://carsapi.unrealos.com/) (OpenAPI 3.0 documentation available)

---

## Key Features

- **Real-Time Car Listings**: Retrieve up-to-date vehicle listings with pricing, mileage, and model details.
- **Detailed Vehicle Information**: Access full specifications, performance inspection reports, history, and warranty data.
- **Advanced Filtering**: Search vehicles by make, model, year, price range, and other parameters.
- **Comprehensive Option Data**: Fetch available features and packages for each vehicle.
- **Scalable and Fast**: Designed for high-performance applications with structured JSON responses.

---

## API Endpoints

Our API follows RESTful principles and supports OpenAPI 3.0 for easy integration.

### 🔹 Listings
`GET /listings`
Retrieve the latest car listings with pagination support.

### 🔹 Vehicle Details
`GET /vehicles/{id}`
Fetch comprehensive details for a specific vehicle, including history and inspection data.

### 🔹 Vehicle Options
`GET /vehicles/{id}/options`
Get the list of available features and packages for a selected vehicle.

### 🔹 Warranty & Category Info
`GET /vehicles/{id}/warranty`
Retrieve extended warranty information.

### 🔹 Manufacturer & Model Data
`GET /categories`
Access structured data on manufacturers, models, and trim levels.

Full API documentation and schema are available at **[carsapi.unrealos.com](https://carsapi.unrealos.com/)**.

---

## Use Cases

- **Automotive Marketplaces**: Power your platform with dynamic, real-time car listings.
- **Analytics & Research**: Gain market insights with structured vehicle data.
- **Car Dealerships & SaaS**: Automate inventory tracking and enhance customer experiences.
- **SEO & Content Platforms**: Improve automotive content visibility with rich data integration.

---

## Get Started

### 🔹 API Documentation
Visit **[carsapi.unrealos.com](https://carsapi.unrealos.com/)** for complete API specifications and OpenAPI 3.0 schema.

### 🔹 Contact Us
For inquiries and API access, contact **[m@unrealos.com](mailto:m@unrealos.com)**.

---

## About Unrealos

The Koreancar API is developed by **[Unrealos](https://unrealos.com)**, a company specializing in AI-powered SaaS and web services. We provide cutting-edge solutions for automotive marketplaces, analytics platforms, and enterprise applications.

