**03** Методы

# Лента новых машин и цен

`GET /v1/changes`

События одного рынка с момента since: новые машины, снятые с продажи, снижение и рост цены. Pro, Max и демо; каждое событие — одна запись квоты.

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

## Параметры

### Лента

- `market` обязателен (query · kr | cn | us) Рынок.
- `since` обязателен (query · ISO 8601) С какого момента, с часовым поясом.
- `type` (query · string · repeatable) Тип события; можно несколько, без него — все.
- `min_pct` (query · number · 0–1000) Наименьшее изменение цены в процентах, по умолчанию 0.5.
- `limit` (query · integer · 1–100) Событий на странице, по умолчанию 20.
- `cursor` (query · string) next_cursor прошлой страницы.

## Запрос `GET`

GET

https://

api.apiauto.space/

v1/

changes?

market=kr

&since=2026-11-03T00:00:00Z

&type=added

cURL:

```bash
curl -s "https://api.apiauto.space/v1/changes?market=kr&since=2026-11-03T00:00:00Z&type=added" \
  -H "X-API-Key: $APIAUTO_KEY"
```

JavaScript:

```js
const response = await fetch(
  "https://api.apiauto.space/v1/changes?market=kr&since=2026-11-03T00:00:00Z&type=added",
  { 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/changes?market=kr&since=2026-11-03T00:00:00Z&type=added",
    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/changes?market=kr&since=2026-11-03T00:00:00Z&type=added");
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
{
  "items": [
    {
      "id": 1001,
      "car_id": "encar:43082263",
      "market": "kr",
      "type": "added",
      "at": "2026-11-03T02:17:42.264668Z",
      "old_price": null,
      "new_price": null,
      "pct": null
    },
    {
      "id": 1002,
      "car_id": "encar:43082202",
      "market": "kr",
      "type": "added",
      "at": "2026-11-03T02:17:42.264668Z",
      "old_price": null,
      "new_price": null,
      "pct": null
    }
  ],
  "next_cursor": "…"
}
```

## Примечания

| Поле события | Что значит |
| --- | --- |
| `id` | Номер события; в примере условный, как и числа ценового события. |
| `car_id` | id машины, как в /v1/cars/{id}. |
| `type` | added · disappeared · price_drop · price_up |
| `at` | Когда событие произошло, UTC. |
| `old_price, new_price` | Цена до и после в валюте рынка; только у ценовых событий. |
| `pct` | Размер изменения в процентах, всегда положительный: направление — в type. |

Как держать каталог свежим по ленте — в разделе [Синхронизация](https://apiauto.space/docs/sync/).

---

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