04 Методы

Живой поиск лотов Copart и IAAI

GET /v1/us/live

Лоты Copart и IAAI прямо у поставщика данных аукционов — для машин, которых нет в копии. Тарифы Pro (2 000 запросов в месяц) и Max (10 000), отдельный счётчик.

Примеры запросов

Параметры

Поиск

make query · string
Марка.
model query · string
Модель.
year_min query · integer
Год от.
year_max query · integer
Год до.
price_max query · integer · USD
Цена до, в долларах.
page query · integer · 1–100
Страница, по умолчанию 1.

Запрос `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);

Получить тестовый ключ

Сайт запросов не отправляет: скопируйте код и запустите со своим ключом.

Ответ

HTTP 200

[
  {
    "id": "copart:74596366",
    "market": "us",
    "source": "copart",
    "source_id": "74596366",
    "title": "2019 Mercedes-Benz Sprinter",
    "brand": "Mercedes-Benz",
    "model": "Sprinter",
    "generation": null,
    "trim": null,
    "year": 2019,
    "mileage_km": 172294,
    "fuel": "diesel",
    "transmission": "automatic",
    "engine_cc": 3000,
    "body_type": "minivan",
    "color": "Black",
    "vin": "WD4PF1CDXKP120163",
    "price": {
      "amount": "21800.00",
      "currency": "USD"
    },
    "price_usd": "21800.00",
    "location": {
      "country": "US",
      "region": "NJ",
      "city": "Glassboro"
    },
    "photos": [
      "https://api.apiauto.space/img/copart:74596366/1.jpg?exp=…&sig=…",
      "https://api.apiauto.space/img/copart:74596366/2.jpg?exp=…&sig=…"
    ],
    "photo_count": 13,
    "listing_url": null,
    "is_active": true,
    "first_seen_at": "2026-11-03T04:44:39.124066Z",
    "last_seen_at": "2026-11-03T04:44:39.124066Z",
    "disappeared_at": null,
    "updated_at": "2026-11-03T04:44:39.124066Z",
    "raw": {
      "fx": {
        "date": "2026-11-02",
        "source": "ECB",
        "currency": "USD",
        "usd_per_unit": "1"
      },
      "bid": null,
      "drive": "rwd",
      "status": 3,
      "airbags": null,
      "buy_now": 21800,
      "latitude": 39.68909,
      "condition": null,
      "cylinders": 6,
      "final_bid": null,
      "longitude": -75.13209,
      "sale_date": "2026-11-09T17:00:00+00:00",
      "title_doc": "clean",
      "video_url": null,
      "grade_iaai": null,
      "lot_number": "74596366",
      "damage_main": "normal_wear",
      "odometer_mi": 107059,
      "damage_second": null,
      "source_values": {
        "fuel": "1",
        "trim": null,
        "brand": "MERCEDES-BENZ",
        "drive": "1",
        "model": "SPRINTER",
        "engine": "3.0L 6",
        "body_type": "Van passenger",
        "title_doc": "CERT OF TITLE",
        "damage_main": "Normal wear",
        "transmission": "1",
        "damage_second": null
      },
      "keys_available": true,
      "location_branch": "NJ - GLASSBORO WEST",
      "odometer_status": null,
      "pre_accident_price": null,
      "clean_wholesale_price": null,
      "estimate_repair_price": null
    },
    "source_mode": "replica"
  }
]

Пример данных: машины настоящие, из каталога на момент сборки сайта; фото сокращены до двух.

Примечания

Ответ — список записей в том же формате, что у каталога; в примере — запись из копии.
Когда поставщик недоступен или исчерпал свой лимит, ответ — 503 с retry_after.
Живой поиск не тратит квоту машин — только свой месячный счётчик: квота и лимиты.
Чем лоты США отличаются от Кореи и Китая — в границах данных.