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`

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

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

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

Ответ

HTTP 200

{
  "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.

Как держать каталог свежим по ленте — в разделе Синхронизация.