vin field (added in V4.1) has been removed. Any length is now accepted again.physics have been renamed across categories to use a consistent naming convention: weight_cargo → cargo_weight and weight_main → gross_weight for Bus and Truck; weight → gross_weight for Agriculture and Construction.New category_fields support for additional categories:
| Category | category_id | Fields |
|---|---|---|
| Boat | 1060 |
brand, model, powertrain, physics, equipment |
| Agriculture Tractor | 1228 |
brand, model, powertrain, condition, physics, tyres, equipment |
| Agriculture Thresher | 1227 |
brand, model, powertrain, condition, physics, equipment |
| Agriculture Tools | 1229 |
brand, model, weight, tools_category |
| Bus | 1321 |
brand, body_type, model, model_year, registration_number, vin, condition, powertrain, physics, equipments |
| Truck | 1322 |
brand, body_type, model, model_year, registration_number, vin, condition, powertrain, physics, equipments |
| Construction | 1323 |
brand, body_type, model_year, vin, service_contract, condition, powertrain, physics |
See the Category Reference for full field specifications and examples.
Typed ad endpoints:
/v4/car, /v4/boat, /v4/bus) that automatically infers the category_id. The category_id field is no longer required when using typed endpoints./v4/ad endpoint continues to work with explicit category_id but is now discouraged in favor of typed endpoints.Breaking changes:
POST /v4/ad/{source_id}/migrate no longer exists. Use the typed migrate endpoints instead (e.g. POST /v4/boat/{source_id}/migrate, POST /v4/truck/{source_id}/migrate). The typed endpoints infer the target category from the URL — do not include category_id in the request body.Other changes:
created and updated fields now include a UTC timezone suffix (Z) and always include microsecond precision, as required by RFC 3339. Example: 2026-05-08T12:00:00.000000Z (previously 2026-05-08T12:00:00). Standard datetime parsers handle both formats — clients using string comparison against timestamps may need to update.source_id now only accepts letters, digits, hyphens, underscores, and dots. Characters like /, ?, and # are rejected with a 400 error.Full registered vehicle support for four categories previously limited to simple ads:
| Category | category_id |
|---|---|
| Moped | 1121 |
| Camper / Motorhome | 1102 |
| Caravan | 1101 |
| Trailer | 1045 |
These categories now support detailed vehicle data (brand, model, mileage, powertrain, physics, equipment, etc.) — the same level of detail as Cars and Motorcycles.
POST /v4/{type}/{source_id}/migrate — converts V3 ads to V4 in-place (the generic /v4/ad/{source_id}/migrate variant was removed in V4.1 — use typed endpoints)warranty, return_policy, service_history, product_declaration, home_delivery