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 requiredquery · kr | cn | us
The market.
since requiredquery · 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`

GEThttps://api.apiauto.space/v1/changes?market=kr&since=2026-11-03T00:00:00Z&type=added

cURL

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

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

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
$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);

Get a test key

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

Response

HTTP 200

{
  "items": [
    {
      "id": 1001,
      "car_id": "encar:43079113",
      "market": "kr",
      "type": "added",
      "at": "2026-11-02T14:34:16.763020Z",
      "old_price": null,
      "new_price": null,
      "pct": null
    },
    {
      "id": 1002,
      "car_id": "encar:43079086",
      "market": "kr",
      "type": "added",
      "at": "2026-11-02T14:34:16.763020Z",
      "old_price": null,
      "new_price": null,
      "pct": null
    }
  ],
  "next_cursor": "…"
}

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

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.