Encar – Official Python Client for Encar API

pip install encar

import os
from encar import CarapisClient, CarapisClientError

# Retrieve the Encar API key from environment variables
API_KEY = os.getenv("CARAPIS_API_KEY")

if not API_KEY:
    print("Error: CARAPIS_API_KEY environment variable not set. Exiting.")
    # Full Encar API access requires a valid key.
    exit()

try:
    # Initialize Encar API client
    client = CarapisClient(api_key=API_KEY)
    print("Carapis Encar API Client initialized successfully.")

    # --- Proceed with Encar API calls below ---

except CarapisClientError as e:
    print(f"Encar API Client Error: {e}")
except Exception as e:
    print(f"An unexpected error occurred: {e}")

try:
    print("\n--- Querying Encar API for Vehicles ---")
    # Fetch vehicle data via Encar API
    vehicles = client.list_vehicles(
        limit=5,
        min_year=2021,
        fuel_type='gasoline',
        max_mileage=50000,
        ordering='-created_at'
    )
    print("Vehicles Found via Encar API:")
    if vehicles and vehicles.get('results'):
        for v in vehicles['results']:
             print(f"- ID: {v.get('vehicle_id')}, Model: {v.get('model_name', 'N/A')}, Price: {v.get('price')}")
    else:
        print("No vehicles found.")

except CarapisClientError as e:
    print(f"Encar API Error listing vehicles: {e}")

try:
    vehicle_id_to_get = 12345678 # Replace with a valid ID
    print(f"\n--- Getting Vehicle Details from Encar API (ID: {vehicle_id_to_get}) ---")
    # Fetch specific vehicle details via Encar API
    vehicle_details = client.get_vehicle(vehicle_id=vehicle_id_to_get)
    print("Vehicle Details Received from Encar API:")
    print(vehicle_details)

except CarapisClientError as e:
    print(f"Encar API Error getting vehicle {vehicle_id_to_get}: {e}")

try:
    print("\n--- Listing Manufacturers from Encar API ---")
    # Fetch manufacturers via Encar API
    manufacturers = client.list_manufacturers(country='KR', limit=10)
    print("Manufacturers Found via Encar API:")
    if manufacturers and manufacturers.get('results'):
        for mfr in manufacturers['results']:
             print(f"- Code: {mfr.get('code')}, Name: {mfr.get('name')}")
    else:
        print("No manufacturers found.")

except CarapisClientError as e:
    print(f"Encar API Error listing manufacturers: {e}")

try:
    manufacturer_code = '101' # Example: Hyundai
    print(f"\n--- Getting Manufacturer Details from Encar API (Code: {manufacturer_code}) ---")
    manufacturer_info = client.get_manufacturer(code=manufacturer_code)
    print("Manufacturer Details Received from Encar API:")
    print(manufacturer_info)

except CarapisClientError as e:
    print(f"Encar API Error getting manufacturer {manufacturer_code}: {e}")

try:
    print("\n--- Getting Manufacturer Stats from Encar API ---")
    mfr_stats = client.get_manufacturer_stats()
    print("Manufacturer Statistics Received from Encar API:")
    print(mfr_stats)

except CarapisClientError as e:
    print(f"Encar API Error getting manufacturer stats: {e}")

try:
    manufacturer_code = '101' # Example: Hyundai
    print(f"\n--- Listing Model Groups from Encar API (Manufacturer: {manufacturer_code}) ---")
    # Fetch model groups via Encar API
    model_groups = client.list_model_groups(manufacturer=manufacturer_code, search='Avante', limit=5)
    print("Model Groups Found via Encar API:")
    if model_groups and model_groups.get('results'):
        for mg in model_groups['results']:
             print(f"- Code: {mg.get('code')}, Name: {mg.get('name')}")
    else:
        print("No model groups found.")

except CarapisClientError as e:
    print(f"Encar API Error listing model groups: {e}")

try:
    model_group_code = '1101' # Example: Avante
    print(f"\n--- Getting Model Group Details from Encar API (Code: {model_group_code}) ---")
    # Fetch model group details via Encar API
    model_group_info = client.get_model_group(code=model_group_code)
    print("Model Group Details Received from Encar API:")
    print(model_group_info)

except CarapisClientError as e:
    print(f"Encar API Error getting model group {model_group_code}: {e}")

try:
    model_group_code = '1101' # Example: Avante
    print(f"\n--- Listing Models from Encar API (Model Group: {model_group_code}) ---")
    # Fetch models via Encar API
    models = client.list_models(model_group=model_group_code, search='CN7', limit=5)
    print("Models Found via Encar API:")
    if models and models.get('results'):
        for mdl in models['results']:
             print(f"- Code: {mdl.get('code')}, Name: {mdl.get('name')}")
    else:
        print("No models found.")

except CarapisClientError as e:
    print(f"Encar API Error listing models: {e}")

try:
    model_code = '21101' # Example: Specific Avante model
    print(f"\n--- Getting Model Details from Encar API (Code: {model_code}) ---")
    # Fetch model details via Encar API
    model_info = client.get_model(code=model_code)
    print("Model Details Received from Encar API:")
    print(model_info)

except CarapisClientError as e:
    print(f"Encar API Error getting model {model_code}: {e}")

try:
    print("\n--- Listing Dealers from Encar API ---")
    # Fetch dealers via Encar API
    dealers = client.list_dealers(limit=5, ordering='name')
    print("Dealers Found via Encar API:")
    if dealers and dealers.get('results'):
        for dealer in dealers['results']:
            print(f"- User ID: {dealer.get('user_id')}, Name: {dealer.get('name')}, Type: {dealer.get('type')}")
    else:
        print("No dealers found.")

except CarapisClientError as e:
    print(f"Encar API Error listing dealers: {e}")

try:
    dealer_user_id = 'some_dealer_id' # Replace with a valid User ID
    print(f"\n--- Getting Dealer Details from Encar API (User ID: {dealer_user_id}) ---")
    # Fetch dealer details via Encar API
    dealer_details = client.get_dealer(user_id=dealer_user_id)
    print("Dealer Details Received from Encar API:")
    print(dealer_details)

except CarapisClientError as e:
    print(f"Encar API Error getting dealer {dealer_user_id}: {e}")

try:
    dealer_user_id = 'some_dealer_id' # Optionally filter by dealer ID
    print(f"\n--- Listing Diagnosis Centers from Encar API (Dealer: {dealer_user_id or 'Any'}) ---")
    # Fetch diagnosis centers via Encar API
    centers = client.list_diagnosis_centers(dealer=dealer_user_id, limit=5)
    print("Diagnosis Centers Found via Encar API:")
    if centers and centers.get('results'):
        for center in centers['results']:
            print(f"- Code: {center.get('code')}, Name: {center.get('name')}, Dealer: {center.get('dealer')}")
    else:
        print("No diagnosis centers found.")

except CarapisClientError as e:
    print(f"Encar API Error listing diagnosis centers: {e}")

try:
    center_code = 'DC001' # Replace with a valid Center Code
    print(f"\n--- Getting Diagnosis Center Details from Encar API (Code: {center_code}) ---")
    # Fetch center details via Encar API
    center_details = client.get_diagnosis_center(code=center_code)
    print("Diagnosis Center Details Received from Encar API:")
    print(center_details)

except CarapisClientError as e:
    print(f"Encar API Error getting diagnosis center {center_code}: {e}")

try:
    print("\n--- Getting Vehicle Enums from Encar API ---")
    # Fetch enums via Encar API
    enums = client.get_vehicle_enums()
    print("Available Enums Received from Encar API:")
    if enums:
        print(f"- Fuel Types: {list(enums.get('FuelType', {}).keys())}")
        print(f"- Colors: {list(enums.get('Color', {}).keys())}")
        # Add more as needed
    else:
         print("Could not retrieve enums.")

except CarapisClientError as e:
    print(f"Encar API Error getting enums: {e}")

try:
    print("\n--- Getting Vehicle Stats from Encar API ---")
    # Fetch stats via Encar API
    vehicle_stats = client.get_vehicle_stats()
    print("Vehicle Statistics Received from Encar API:")
    print(vehicle_stats)

except CarapisClientError as e:
    print(f"Encar API Error getting stats: {e}")