**03** Endpoints

# Feed of new cars and prices

`GET /v1/changes`

Events of one market since a moment: new cars, cars taken off sale, price drops and rises. Pro, Max and the demo; each event costs one record.

Example requests

## Parameters

### Feed

- `market` required (query · kr | cn | us) The market.
- `since` required (query · ISO 8601) From which moment, with a time zone.
- `type` (query · string · repeatable) The event type; repeatable, all types without it.
- `min_pct` (query · number · 0–1000) The smallest price change in percent, 0.5 by default.
- `limit` (query · integer · 1–100) Events per page, 20 by default.
- `cursor` (query · string) The next_cursor of the previous page.

## Request `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);
```

## Response

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": "…"
}
```

## Notes

| Event field | Meaning |
| --- | --- |
| `id` | The event's number; made up in the sample, like the price event's numbers. |
| `car_id` | The car's id, as in /v1/cars/{id}. |
| `type` | added · disappeared · price_drop · price_up |
| `at` | When it happened, UTC. |
| `old_price, new_price` | The price before and after in the market's currency; price events only. |
| `pct` | The size of the change in percent, always positive: the direction is in type. |

How to keep a catalog fresh from the feed is in [Keeping in sync](https://apiauto.space/en/docs/sync/).

---

Page: https://apiauto.space/en/docs/endpoints/changes/