**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`

GET

https://

api.apiauto.space/

v1/

us/

live?

make=Toyota

&model=Camry

&year_min=2020

cURL:

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

JavaScript:

```js
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:

```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
<?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:

```json
[
  {
    "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.
- Живой поиск не тратит квоту машин — только свой месячный счётчик: [квота и лимиты](https://apiauto.space/docs/limits/) .
- Чем лоты США отличаются от Кореи и Китая — в [границах данных](https://apiauto.space/docs/markets/) .

---

Страница: https://apiauto.space/docs/endpoints/live/