Designed for car dealers
A pragmatic format that travels well across tools and teams.
Simple
Publish all your car listings in one simple JSON file that any data consumer can read out of the box.
Complete
Covers cars, showrooms, and dealer details — including foreign keys between resources for multi-location dealerships.
Standard
Built on the widely-used Fairspec / Data Package standard, making it compatible with the wider ecosystem.
Automatic
Python and TypeScript SDKs are generated from the schemas — no hand-written models, no drift between languages.
Versioned
Semantic versioning, GitHub releases, and an auto-published changelog wired up out of the box.
Documented
Specification, table schemas, and examples render to a Livemark documentation site that ships with the format.
One JSON file. Every car listing.
Describe your dealer, your showrooms, and your cars in a single file — validated against shared schemas.
{
"$schema": "https://fairspec.github.io/fairspec-cardealer/profiles/0.4.0/dataset.json",
"resources": [
{
"name": "dealer",
"schema": "https://fairspec.github.io/fairspec-cardealer/schemas/0.4.0/dealer.json",
"data": [
{
"title": "Premium Auto Sales",
"city": "Los Angeles",
"url": "https://premiumauto.example"
}
]
},
{
"name": "car",
"schema": "https://fairspec.github.io/fairspec-cardealer/schemas/0.4.0/car.json",
"data": [
{
"url": "https://premiumauto.example/cars/m3",
"brand": "BMW",
"model": "M3 Competition",
"year": 2024,
"price": 76000
}
]
}
]
}Ready to publish your listings? Start with one JSON file.
Read the format, drop in an example, and have your dealer feed shareable in minutes.
Built on open, well-adopted standards