API versions and changelog

Compatibility

Within /v1 fields are never removed or renamed; new optional fields may appear — do not fail on unknown keys. Breaking changes will ship under /v2 with a transition period announced in the bot.

Changelog

October 2026: model generation and family

• The generation field (Korea) and the catalog's generation filter; model is the model family, one name in every market.

September 2026: API v1 released

• Catalog, car by id, change feed, references, usage, live US search.
• Signed photo links through /img.
• Makes and models are spelled the same in every market (Ford, Mercedes-Benz, CX-5, XC60); the original spellings stay in raw.source_values.
• /v1/references/markets has data_age_seconds and stale: how fresh each market's copy is.