04 Endpoints

Live search of Copart and IAAI lots

GET /v1/us/live

Copart and IAAI lots straight from the auction data provider — for cars that are not in the copy. Pro (2,000 requests a month) and Max (10,000), a separate counter.

Example requests

Parameters

Search

make query · string
Make.
model query · string
Model.
year_min query · integer
Year from.
year_max query · integer
Year to.
price_max query · integer · USD
Price up to, in dollars.
page query · integer · 1–100
The page, 1 by default.

Request `GET`

GEThttps://api.apiauto.space/v1/us/live?make=Toyota&model=Camry&year_min=2020

cURL

curl -s "https://api.apiauto.space/v1/us/live?make=Toyota&model=Camry&year_min=2020" \
  -H "X-API-Key: $APIAUTO_KEY"

JavaScript

const response = await fetch(
  "https://api.apiauto.space/v1/us/live?make=Toyota&model=Camry&year_min=2020",
  { headers: { "X-API-Key": process.env.APIAUTO_KEY } },
);
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();

Python

import os
import httpx

data = httpx.get(
    "https://api.apiauto.space/v1/us/live?make=Toyota&model=Camry&year_min=2020",
    headers={"X-API-Key": os.environ["APIAUTO_KEY"]},
    timeout=30,
).raise_for_status().json()

PHP

<?php
$ch = curl_init("https://api.apiauto.space/v1/us/live?make=Toyota&model=Camry&year_min=2020");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Get a test key

The site sends no requests: copy the code and run it with your key.

Response

HTTP 200

[
  {
    "id": "copart:74451256",
    "market": "us",
    "source": "copart",
    "source_id": "74451256",
    "title": "2024 Hyundai Elantra",
    "brand": "Hyundai",
    "model": "Elantra",
    "generation": null,
    "trim": null,
    "year": 2024,
    "mileage_km": 84823,
    "fuel": "gasoline",
    "transmission": "automatic",
    "engine_cc": 2000,
    "body_type": "sedan",
    "color": "Gray",
    "vin": "KMHLM4DG9RU821664",
    "price": {
      "amount": "14000.00",
      "currency": "USD"
    },
    "price_usd": "14000.00",
    "location": {
      "country": "US",
      "region": "IL",
      "city": "Chicago Heights"
    },
    "photos": [
      "https://api.apiauto.space/img/copart:74451256/1.jpg?exp=…&sig=…",
      "https://api.apiauto.space/img/copart:74451256/2.jpg?exp=…&sig=…"
    ],
    "photo_count": 11,
    "listing_url": null,
    "is_active": true,
    "first_seen_at": "2026-11-03T00:15:49.819982Z",
    "last_seen_at": "2026-11-03T00:15:49.819982Z",
    "disappeared_at": null,
    "updated_at": "2026-11-03T00:15:49.819982Z",
    "raw": {
      "fx": {
        "date": "2026-11-02",
        "source": "ECB",
        "currency": "USD",
        "usd_per_unit": "1"
      },
      "bid": null,
      "drive": "fwd",
      "status": 3,
      "airbags": null,
      "buy_now": 14000,
      "latitude": 41.5070957,
      "condition": null,
      "cylinders": 4,
      "final_bid": null,
      "longitude": -87.6159798,
      "sale_date": "2026-11-04T17:00:00+00:00",
      "title_doc": "clean",
      "video_url": null,
      "grade_iaai": null,
      "lot_number": "74451256",
      "damage_main": "front",
      "odometer_mi": 52707,
      "damage_second": null,
      "source_values": {
        "fuel": "4",
        "trim": null,
        "brand": "HYUNDAI",
        "drive": "2",
        "model": "ELANTRA",
        "engine": "2.0L 4",
        "body_type": "Sedan",
        "title_doc": "CERTIFICATE OF TITLE",
        "damage_main": "Front end",
        "transmission": "1",
        "damage_second": null
      },
      "keys_available": true,
      "location_branch": "IL - CHICAGO SOUTH",
      "odometer_status": null,
      "pre_accident_price": null,
      "clean_wholesale_price": null,
      "estimate_repair_price": null
    },
    "source_mode": "replica"
  }
]

Sample data: the cars are real, from the catalog when the site was built; photos are cut to two.

Notes

The answer is a list of records in the catalog's format; the sample shows a record from the copy.
When the provider is down or out of its own limit, the answer is 503 with retry_after.
Live search does not spend the car quota — only its own monthly counter: quota and limits.
How the US lots differ from Korea and China: data boundaries.