{"openapi":"3.1.1","info":{"title":"Zero KM public API","version":"1.0.0","description":"Find new-car price drops, below-usual prices and current dealer cash quotes in Argentina. Catalogue monitored five times daily, with per-version quote dates, original ARS/USD prices and specifications traced to official Argentine sources. No account or API key. Use find_deals for opportunities and get_model_prices for a model’s lowest prices; visit Zero KM for charts and a saved shortlist. Prices come from El Cero KM; cite vehicle and source links with observation dates."},"servers":[{"url":"https://zero-km.vercel.app"}],"externalDocs":{"url":"https://zero-km.vercel.app/developers"},"paths":{"/api/v1":{"get":{"operationId":"get_api_info","summary":"API version, snapshot date and entry-point links.","responses":{"200":{"description":"API entry points.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiInfo"}}}}}}},"/api/v1/deals":{"get":{"operationId":"find_deals","summary":"Find opportunities","description":"Find new-car buying opportunities in Argentina by budget, model and specs: below-usual prices, price drops in the last 1/3/7 days, or newly qualifying deals. Returns reasons, before/after prices where available, quote dates and links to explore on Zero KM.","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Words in make, model or version; case and accent insensitive.","type":"string","maxLength":200}},{"name":"make","in":"query","required":false,"schema":{"description":"Exact make, case and accent insensitive.","type":"string","minLength":1,"maxLength":100}},{"name":"model","in":"query","required":false,"schema":{"description":"Exact model, case and accent insensitive.","type":"string","minLength":1,"maxLength":100}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["SUV","Pickup","Hatchback","Sedan","Van","Coupe","Wagon","MPV","Other"]}},{"name":"fuel","in":"query","required":false,"schema":{"type":"string","enum":["Petrol","Diesel","Electric","Hybrid","Mild hybrid","Plug-in hybrid","Range extender"]}},{"name":"transmission","in":"query","required":false,"schema":{"type":"string","enum":["Automatic","Manual"]}},{"name":"minPriceUsd","in":"query","required":false,"schema":{"description":"Minimum detailed quote in USD.","type":"number","minimum":0}},{"name":"maxPriceUsd","in":"query","required":false,"schema":{"description":"Maximum detailed quote in USD.","type":"number","minimum":0}},{"name":"minSeats","in":"query","required":false,"schema":{"description":"Minimum confirmed seats; excludes unknown values.","type":"integer","minimum":1,"maximum":100}},{"name":"minAirbags","in":"query","required":false,"schema":{"description":"Minimum confirmed airbags; excludes unknown values.","type":"integer","minimum":0,"maximum":30}},{"name":"drivetrain","in":"query","required":false,"schema":{"type":"string","enum":["fwd","rwd","4x2","awd","4x4","4x4-low-range"]}},{"name":"aeb","in":"query","required":false,"schema":{"description":"True includes confirmed low-speed AEB; unknown or optional is excluded.","type":"boolean"}},{"name":"hasSpecs","in":"query","required":false,"schema":{"description":"Whether official technical specifications are available.","type":"boolean"}},{"name":"minDiscountPct","in":"query","required":false,"schema":{"description":"Requires sufficient price history.","type":"number","minimum":0,"maximum":100}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"description":"Maximum records per page.","type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"description":"Records to skip; follow pagination.nextOffset.","type":"integer","minimum":0,"maximum":100000}},{"name":"kind","in":"query","required":false,"schema":{"default":"opportunities","description":"Below-usual prices, recent price reductions, or newly qualifying opportunities.","type":"string","enum":["opportunities","price_drops","new_opportunities"]}},{"name":"window","in":"query","required":false,"schema":{"default":"7d","description":"Recent-change window, relative to catalogueObservedAt. Applies to price_drops and new_opportunities.","type":"string","enum":["1d","3d","7d"]}},{"name":"sort","in":"query","required":false,"schema":{"default":"recommended","description":"Recommended ranks opportunities by discount, recent price drops by percentage, and new opportunities by recency.","type":"string","enum":["recommended","recent","price_asc","discount_desc"]}}],"responses":{"200":{"description":"Published catalogue snapshot, with per-version observation dates.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/Deals"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"description":"Use GET, HEAD or OPTIONS."}}}},"/api/v1/models/prices":{"get":{"operationId":"get_model_prices","summary":"Model prices","description":"Get current prices for an exact make and model in Argentina: starting price, cheapest version and quote, price range, opportunity count and versions ordered by price. Follow the model link for charts and detailed exploration.","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"model","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"description":"Maximum records per page.","type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"description":"Records to skip; follow pagination.nextOffset.","type":"integer","minimum":0,"maximum":100000}}],"responses":{"200":{"description":"Published catalogue snapshot, with per-version observation dates.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/ModelPrices"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"description":"Use GET, HEAD or OPTIONS."}}}},"/api/v1/vehicles":{"get":{"operationId":"search_vehicles","summary":"Search versions","description":"Find the lowest current new-car prices in Argentina by budget, make, model and sourced specifications. Defaults to cheapest first. For recent price drops and buying opportunities use find_deals; get_vehicle provides all current quotes.","parameters":[{"name":"q","in":"query","required":false,"schema":{"description":"Words in make, model or version; case and accent insensitive.","type":"string","maxLength":200}},{"name":"make","in":"query","required":false,"schema":{"description":"Exact make, case and accent insensitive.","type":"string","minLength":1,"maxLength":100}},{"name":"model","in":"query","required":false,"schema":{"description":"Exact model, case and accent insensitive.","type":"string","minLength":1,"maxLength":100}},{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["SUV","Pickup","Hatchback","Sedan","Van","Coupe","Wagon","MPV","Other"]}},{"name":"fuel","in":"query","required":false,"schema":{"type":"string","enum":["Petrol","Diesel","Electric","Hybrid","Mild hybrid","Plug-in hybrid","Range extender"]}},{"name":"transmission","in":"query","required":false,"schema":{"type":"string","enum":["Automatic","Manual"]}},{"name":"minPriceUsd","in":"query","required":false,"schema":{"description":"Minimum detailed quote in USD.","type":"number","minimum":0}},{"name":"maxPriceUsd","in":"query","required":false,"schema":{"description":"Maximum detailed quote in USD.","type":"number","minimum":0}},{"name":"minSeats","in":"query","required":false,"schema":{"description":"Minimum confirmed seats; excludes unknown values.","type":"integer","minimum":1,"maximum":100}},{"name":"minAirbags","in":"query","required":false,"schema":{"description":"Minimum confirmed airbags; excludes unknown values.","type":"integer","minimum":0,"maximum":30}},{"name":"drivetrain","in":"query","required":false,"schema":{"type":"string","enum":["fwd","rwd","4x2","awd","4x4","4x4-low-range"]}},{"name":"aeb","in":"query","required":false,"schema":{"description":"True includes confirmed low-speed AEB; unknown or optional is excluded.","type":"boolean"}},{"name":"hasSpecs","in":"query","required":false,"schema":{"description":"Whether official technical specifications are available.","type":"boolean"}},{"name":"opportunitiesOnly","in":"query","required":false,"schema":{"description":"At least 5% below typical price with sufficient history.","type":"boolean"}},{"name":"minDiscountPct","in":"query","required":false,"schema":{"description":"Requires sufficient price history.","type":"number","minimum":0,"maximum":100}},{"name":"sort","in":"query","required":false,"schema":{"default":"price_asc","type":"string","enum":["price_asc","price_desc","discount_desc","name"]}},{"name":"limit","in":"query","required":false,"schema":{"default":20,"description":"Maximum records per page.","type":"integer","minimum":1,"maximum":100}},{"name":"offset","in":"query","required":false,"schema":{"default":0,"description":"Records to skip; follow pagination.nextOffset.","type":"integer","minimum":0,"maximum":100000}}],"responses":{"200":{"description":"Published catalogue snapshot, with per-version observation dates.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/Search"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"description":"Use GET, HEAD or OPTIONS."}}}},"/api/v1/vehicles/{id}":{"get":{"operationId":"get_vehicle","summary":"Version quotes","description":"Inspect a version’s current dealer cash quotes in original ARS/USD, fees, stock at observation, quote-check dates and official specification sources. Includes compact opportunity evidence and a Zero KM link for the full chart and saved shortlist.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","minLength":1,"maxLength":160,"description":"Original vehicle ID returned in pricing or search results."}}],"responses":{"200":{"description":"Published catalogue snapshot, with per-version observation dates.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/Detail"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"description":"Use GET, HEAD or OPTIONS."}}}},"/api/v1/compare":{"get":{"operationId":"compare_vehicles","summary":"Compare versions","description":"Compare two to four versions by current prices, buying signals and sourced specifications. Returns a shareable Zero KM comparison page. Missing specifications remain unknown.","parameters":[{"name":"ids","in":"query","required":true,"schema":{"minItems":2,"maxItems":4,"type":"array","items":{"type":"string","minLength":1,"maxLength":160,"description":"Original vehicle ID returned in pricing or search results."},"description":"Two to four distinct vehicle IDs; comma-separated in HTTP, a JSON array in MCP."},"style":"form","explode":false}],"responses":{"200":{"description":"Published catalogue snapshot, with per-version observation dates.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/Compare"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"description":"Use GET, HEAD or OPTIONS."}}}},"/api/v1/catalogue":{"get":{"operationId":"get_catalogue","summary":"Catalogue","description":"Discover supported makes, models, filter values, coverage counts and snapshot dates before narrowing a price or opportunity search.","parameters":[],"responses":{"200":{"description":"Published catalogue snapshot, with per-version observation dates.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Envelope"},{"properties":{"data":{"$ref":"#/components/schemas/Catalogue"}}}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"405":{"description":"Use GET, HEAD or OPTIONS."}}}}},"components":{"schemas":{"ApiInfo":{"type":"object","properties":{"name":{"type":"string"},"version":{"type":"string"},"snapshotAt":{"type":"string","format":"date-time"},"documentationUrl":{"type":"string","format":"uri"},"openapiUrl":{"type":"string","format":"uri"},"mcpUrl":{"type":"string","format":"uri"},"endpoints":{"type":"array","items":{"type":"string"}}},"required":["name","version","snapshotAt","documentationUrl","openapiUrl","mcpUrl","endpoints"]},"Envelope":{"type":"object","properties":{"schemaVersion":{"type":"integer","const":1},"snapshotAt":{"type":"string","format":"date-time"},"catalogueObservedAt":{"type":"string","format":"date-time"},"source":{"type":"string","format":"uri"},"methodologyUrl":{"type":"string","format":"uri"},"documentationUrl":{"type":"string","format":"uri"},"data":{"type":"object"}},"required":["schemaVersion","snapshotAt","catalogueObservedAt","source","methodologyUrl","documentationUrl","data"]},"Pagination":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1},"offset":{"type":"integer","minimum":0},"nextOffset":{"type":["integer","null"],"minimum":0}},"required":["total","limit","offset","nextOffset"]},"Comparison":{"type":"object","properties":{"windowDays":{"type":"integer","const":180},"typicalPriceUsd":{"type":["number","null"]},"lowestPriceUsd":{"type":["number","null"]},"discountPct":{"type":["number","null"],"description":"Percentage below the usual-price benchmark, not a manufacturer list-price discount. Use opportunity for the qualified signal."},"observedWeeks":{"type":"integer"},"sufficientHistory":{"type":"boolean"},"opportunity":{"type":"boolean"}},"required":["windowDays","typicalPriceUsd","lowestPriceUsd","discountPct","observedWeeks","sufficientHistory","opportunity"]},"Summary":{"type":"object","properties":{"id":{"type":"string"},"url":{"type":"string","format":"uri","description":"Canonical Zero KM page for the full chart, specifications and saving a shortlist."},"feedUrl":{"type":"string","format":"uri"},"sourceUrl":{"type":"string","format":"uri"},"make":{"type":"string"},"model":{"type":"string"},"trim":{"type":"string"},"trimDisplay":{"type":"string"},"type":{"type":"string"},"tier":{"type":"string"},"tierLabel":{"type":["string","null"]},"fuel":{"type":["string","null"]},"transmission":{"type":["string","null"]},"seats":{"type":["number","null"]},"airbags":{"type":["number","null"]},"factSources":{"type":"object","additionalProperties":{"type":"string"}},"observedAt":{"type":"string","format":"date-time","description":"When this version’s detailed quotes and stock were checked; independent of the site-wide snapshot date."},"currentPriceUsd":{"type":"number","description":"Lowest detailed dealer quote in USD at observedAt. Recent catalogue change prices may be newer."},"comparison":{"$ref":"#/components/schemas/Comparison"},"hasSpecs":{"type":"boolean"},"recentChanges":{"type":"object","properties":{"1d":{"$ref":"#/components/schemas/RecentChange"},"3d":{"$ref":"#/components/schemas/RecentChange"},"7d":{"$ref":"#/components/schemas/RecentChange"}},"required":["1d","3d","7d"]},"quoteCount":{"type":"integer","minimum":0},"bestQuote":{"anyOf":[{"$ref":"#/components/schemas/Quote"},{"type":"null"}]},"availability":{"const":"InStock","type":"string","description":"The listing had stock in the source at observedAt."},"reasons":{"type":"array","items":{"enum":["below_typical","price_drop","new_opportunity"]}}},"required":["id","url","sourceUrl","make","model","trim","observedAt","currentPriceUsd","comparison","hasSpecs","recentChanges","quoteCount","bestQuote","availability","reasons"]},"Quote":{"type":"object","properties":{"id":{"type":["string","number"]},"price":{"type":"number"},"currency":{"enum":["ARS","USD"]},"priceUsd":{"type":"number"},"feesIncluded":{"type":["boolean","null"]},"color":{"type":["string","null"]},"stock":{"type":["number","null"]},"location":{"type":["string","null"]},"sellerId":{"type":["string","number","null"]}},"required":["id","price","currency","priceUsd","feesIncluded","color"]},"Specs":{"type":["object","null"],"properties":{"collectedAt":{"type":"string"},"sourceLabel":{"type":["string","null"]},"values":{"type":"object","description":"Original sourced values. Missing values mean unknown. Unit suffixes and powerUnit define units; equipment can be true, false or optional."},"sourceOf":{"type":"object","additionalProperties":{"type":"string"}},"sources":{"type":"object","additionalProperties":{"type":"object","properties":{"publisher":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"kind":{"type":"string"},"documentDate":{"type":["string","null"]},"retrievedAt":{"type":"string"}}}},"gaps":{"type":"object","description":"Missing, disputed, contradictory, unreadable or unassigned source values."}}},"Vehicle":{"allOf":[{"$ref":"#/components/schemas/Summary"},{"type":"object","properties":{"quotes":{"type":"array","items":{"$ref":"#/components/schemas/Quote"}},"exchangeRate":{"type":"object","properties":{"arsPerUsd":{"type":["number","null"]},"observedAt":{"type":"string","format":"date-time"}},"required":["arsPerUsd","observedAt"]},"specs":{"$ref":"#/components/schemas/Specs"}},"required":["quotes","exchangeRate","specs"]}]},"RecentChange":{"type":["object","null"],"properties":{"kind":{"enum":["price_drop","new_opportunity"]},"changedAt":{"type":["string","null"],"format":"date-time","description":"Detected catalogue change time, or null for qualification without a new price change."},"qualifiedSince":{"type":["string","null"],"format":"date-time","description":"Monitoring-window boundary for a newly qualifying opportunity without a price change; not an exact event time."},"dropPct":{"type":["number","null"],"description":"Positive percentage price reduction; compares native prices when currencies match. Null when there was no reduction."},"previousPriceUsd":{"type":["number","null"],"description":"Reference catalogue price converted at the current observed exchange rate, isolating price movement from FX."},"currentPriceUsd":{"type":"number","description":"Current catalogue price converted at the same observed rate as previousPriceUsd. May differ from the last detailed quote."},"conversionBasis":{"const":"current_observed_exchange_rate","type":"string"}},"required":["kind","changedAt","qualifiedSince","dropPct","previousPriceUsd","currentPriceUsd","conversionBasis"]},"Catalogue":{"type":"object","properties":{"vehicleCount":{"type":"integer"},"modelCount":{"type":"integer"},"versionsWithSpecs":{"type":"integer"},"opportunityCount":{"type":"integer"},"makes":{"type":"array","items":{"type":"string"}},"models":{"type":"array","items":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"}},"required":["make","model"]}},"filters":{"type":"object","additionalProperties":{"type":"array","items":{"type":["string","number"]}}}},"required":["vehicleCount","modelCount","versionsWithSpecs","opportunityCount","makes","models","filters"]},"Search":{"type":"object","properties":{"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Summary"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["vehicles","pagination"]},"Detail":{"type":"object","properties":{"vehicle":{"$ref":"#/components/schemas/Vehicle"}},"required":["vehicle"]},"Deals":{"type":"object","properties":{"kind":{"enum":["opportunities","price_drops","new_opportunities"]},"window":{"enum":["1d","3d","7d"]},"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Summary"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["kind","window","vehicles","pagination"]},"ModelPrices":{"type":"object","properties":{"make":{"type":"string"},"model":{"type":"string"},"url":{"type":"string","format":"uri"},"fromPriceUsd":{"type":"number"},"toPriceUsd":{"type":"number"},"versionCount":{"type":"integer"},"opportunityCount":{"type":"integer"},"cheapestVersion":{"$ref":"#/components/schemas/Summary"},"quoteDates":{"type":"object","properties":{"oldest":{"type":"string","format":"date-time"},"newest":{"type":"string","format":"date-time"}},"required":["oldest","newest"]},"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Summary"}},"pagination":{"$ref":"#/components/schemas/Pagination"}},"required":["make","model","url","fromPriceUsd","toPriceUsd","versionCount","opportunityCount","cheapestVersion","quoteDates","vehicles","pagination"]},"Compare":{"type":"object","properties":{"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Vehicle"},"minItems":2,"maxItems":4},"url":{"type":"string","format":"uri"}},"required":["vehicles","url"]},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"]}}},"required":["code","message"]}},"required":["error"]}},"responses":{"BadRequest":{"description":"Invalid or unknown parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Unknown vehicle ID or API route.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}