changedInput schema / properties / body / description
Previous value: -"body_slug, e.g. suv, sedan, hatchback"New value: +"Body type, case-insensitive substring of the English label — e.g. suv, sedan, hatchback"
changedInput schema / properties / drive / description
Previous value: -"substring match, e.g. 'front', 'rear', 'all'"New value: +"Drive layout, substring match — e.g. 'front', 'rear', 'all'. Not applied by the demo set — reported back in ignored_filters."
addedInput schema / properties / ev / description
Added value: +"true = only variants with a traction battery (battery_kwh set: electric and plug-in). Default: false"
changedInput schema / properties / fuel / description
Previous value: -"e.g. petrol, diesel, electric, hybrid"New value: +"Fuel type, case-insensitive substring of the English label — e.g. petrol, diesel, electric, hybrid"
addedInput schema / properties / limit / description
Added value: +"Maximum number of results, 1–50. Default: 10."
addedInput schema / properties / locale / description
Added value: +"Response language, one of the 20 published languages (en, ro, fr, de, es, it, sr, hr, pt, pl, cs, sk, hu, no, sv, el, bg, da, ar, tr). Spec labels and enum values come back translated. Default: en."
addedInput schema / properties / power_max / description
Added value: +"Maximum power, hp"
addedInput schema / properties / power_min / description
Added value: +"Minimum power, hp"
addedInput schema / properties / price_max / description
Added value: +"Maximum new list price, EUR"
addedInput schema / properties / year / description
Added value: +"Production year the generation covers, e.g. 2022. Not applied by the demo set — reported back in ignored_filters."
changedOutput schema / (root)
Previous value: -nullNew value: +{
+ "$schema": "http://json-schema.org/draft-07/schema#",
+ "additionalProperties": {},
+ "properties": {
+ "data": {
+ "description": "Matches; empty when nothing matches",
+ "items": {
+ "additionalProperties": {},
+ "properties": {
+ "battery_kwh": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Traction battery capacity, kWh; null without one"
+ },
+ "body_type_en": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Body type, English label"
+ },
+ "brand": {
+ "type": "string"
+ },
+ "display_name": {
+ "description": "Full variant name",
+ "type": "string"
+ },
+ "fuel_slug": {
+ "description": "Fuel type, English label (e.g. Electric, Petrol)",
+ "type": "string"
+ },
+ "generation": {
+ "description": "Generation name",
+ "type": "string"
+ },
+ "generation_id": {
+ "description": "Opaque generation id — tells same-named variants of different generations apart",
+ "type": "string"
+ },
+ "model": {
+ "type": "string"
+ },
+ "model_id": {
+ "description": "Opaque model id, e.g. m_1a2b3c4d. Pass it to list_generations.",
+ "type": "string"
+ },
+ "power_hp": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Power, hp"
+ },
+ "price_new_eur": {
+ "anyOf": [
+ {
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "New list price, EUR"
+ },
+ "variant_id": {
+ "description": "Opaque variant id, e.g. v_1a2b3c4d. Pass it to get_specs / get_images / compare_variants.",
+ "type": "string"
+ },
+ "years": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ],
+ "description": "Production years, e.g. '2019–2024'; an open range '2021–' is still in production"
+ }
+ },
+ "required": [
+ "variant_id",
+ "generation_id",
+ "model_id",
+ "display_name",
+ "brand",
+ "model",
+ "generation",
+ "fuel_slug",
+ "body_type_en",
+ "years",
+ "power_hp",
+ "battery_kwh",
+ "price_new_eur"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "demo": {
+ "description": "true when answered from the demo set",
+ "type": "boolean"
+ },
+ "ignored_filters": {
+ "description": "Filters you passed that the demo set cannot apply — results are NOT narrowed by them",
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "type": "object"
+}
