coches APIcoches.net ↗

"""Coches.net SDK — search vehicles, browse makes, get specs and pricing."""
from parse_apis.coches_net_api import CochesNet, SortTerm, FuelType, Category, Sort, VehicleNotFound

client = CochesNet()

# Browse the full makes catalog and pick the first make's models.
first_make = client.makes.list(limit=3).first()
print(f"Make: {first_make.label}, models: {len(first_make.models)}")
for m in first_make.models[:2]:
    print(f"  Model: {m.label} (id={m.id})")

# Search used diesel vehicles sorted by price ascending, capped at 5 results.
for vehicle in client.vehiclesummaries.search(
    query="BMW",
    fuel_type_ids=FuelType.DIESEL,
    category_ids=Category.USED,
    sort_term=SortTerm.PRICE,
    sort_order=Sort.ASC,
    limit=5,
):
    print(f"{vehicle.title} — {vehicle.year}, {vehicle.km} km, {vehicle.hp} HP, {vehicle.main_province}")

# Drill into one vehicle's full detail and technical specs.
vehicle = client.vehiclesummaries.search(query="Audi", sort_term=SortTerm.YEAR, limit=1).first()
if vehicle:
    detail = vehicle.details()
    print(f"Detail: {detail.title}, price={detail.price}€, views={detail.views}")

    specs = vehicle.technical_specs()
    print(f"Specs: {specs.horse_power} HP, {specs.number_of_doors} doors, trim={specs.trim_level}")

    pricing = vehicle.price_analysis()
    print(f"Price analysis: {pricing.price}€, financed: {pricing.financed_price}, rank: {pricing.rank}")

# Typed error handling for a missing vehicle.
try:
    missing = client.vehiclesummary(id="99999999999")
    missing.technical_specs()
except VehicleNotFound as exc:
    print(f"Not found: {exc.vehicle_id}")

print("Exercised: makes.list / vehiclesummaries.search / details / technical_specs / price_analysis / VehicleNotFound")