The dataset behind every page, documented at the source.

base       = https://carconomics.com
format     = JSON over plain GET · no auth header
groups     = tesla (default) | luxury — never blended in one response
markets    = ord (Chicago O'Hare) | lax (Los Angeles LAX)
prices     = trip totals in USD, before taxes
timestamps = ISO 8601 UTC
dates      = ISO yyyy-mm-dd, always inside the published window

{
  "query":         { /* the parsed plan echoed back — normalized, never raw input */ },
  "comboCount":    84,             // pickup-date × trip-length combos this plan expands to
  "listings": [ /* ≤40 per page */ {
    "id":            "<start>-<listingId>-<days>d",
    "listingId":     "1543210",
    "market":        "ord",
    "startDate":     "<ISO pickup date>",
    "rentalDays":    3,
    "make":          "Tesla",
    "model":         "Model 3",
    "trim":          "",
    "year":          2023,
    "price":         141,          // trip total USD, before taxes
    "rating":        4.9,
    "trips":         112,
    "allStar":       true,
    "city":          "Schaumburg, IL",
    "image":         "https://…",
    "url":           "https://turo.com/…",  // exact compared dates prefilled
    "distanceMi":    6.4,          // from the market's airport search point
    "carried":       true,         // present = last-seen quote, not fresh this refresh
    "beforeDiscount": 178,         // pre-discount total; present only when > price
    "fairPerDay":    52,           // present only when this snapshot's pricing validated
    "savePct":       0.22,         // 0.22 = 22% under fair; negative = over
    "steal":         true,         // server-decided; absent when evidence is weak
    "cheaperLonger": { "days": 5, "price": 133 },
    "matchingTripCount": 9,
    "rentalValue":   { "score": 41, "rank": 3, "cohortSize": 118, "topValuePick": false } // score is stored 0–50; the site shows it ×2, out of 100
  } ],
  "offset":        0,
  "totalMatched":  1187,           // full match count before pagination
  "totalVehicles": 236,            // distinct cars among the matches
  "totalTrips":    1187,           // exact trip options among the matches
  "snapshotId":    "…",            // immutable content generation this page was sorted against
  "nextCursor":    "…",            // opaque; null on the last page
  "hasMore":       true,
  "insights":      { "deal": {…}, "newest": {…}, "fastest": {…}, "reviewed": {…} },
  "meta": {
    "source":       "live",        // "empty" = no data pushed yet
    "group":        "tesla",       // always stamped
    "checkedAt":    "<ISO timestamp>",
    "staleMinutes": 24,
    "bounds":       { "minDate": "…", "maxDate": "…", "windowDays": 60, "supportedLengths": [1, …, 14] },
    "pricingValidated": false,     // fair/save fields are withheld when false
    "observedThrough":  "<ISO timestamp>",
    "publishedAt":      "<ISO timestamp>",
    "coverage":     { "ord": { "successfulDateRatio": 1, "freshRatio": 0.99, … }, "lax": {…} }
  }
}

$ PICKUP=$(date -v+10d +%F)     # any date inside meta.bounds
$ curl -s "https://carconomics.com/api/search?market=all&targetDate=$PICKUP&minLength=3&maxLength=6&sort=price" \
    | jq '{totalMatched, snapshotId, hasMore, first: .listings[0] | {model, year, price, startDate}}'
{
  "totalMatched": 1187,                  // sample values — run it for real ones
  "snapshotId": "b41c0f…",
  "hasMore": true,
  "first": { "model": "Model 3", "year": 2023, "price": 141, "startDate": "…" }
}

{
  "status":          "ok",              // or "unavailable" + reason (still HTTP 200)
  "group":           "tesla",
  "formulaVersion":  "…",               // exact Rental Value formula generation
  "contentId":       "…",
  "generationId":    "…",
  "observedThrough": "<ISO timestamp>",
  "publicationKind": "observation",     // or curation_rebuild | repush
  "markets": [ {
    "market":      "ord",
    "marketLabel": "Chicago · ORD",
    "evidence":    { "status": "supported", "reasons": [], "marketFreshShare": 0.99,
                     "baseEligiblePopulation": 240, "rankedPopulation": 118 },
    "rows": [ {
      "listingId": "1543210", "score": 41, "rank": 1, "cohortSize": 118,
      "topValuePick": true, "percentile": 0.99,
      "peerKind": "model", "peerValue": "Model 3", "peerCount": 62,
      "axes": { /* five fixed axes, each { value, score } */ },
      "representativeQuote": { "startDate": "<ISO date>", "rentalDays": 3, "total": 141, "dailyRate": 47 },
      "robustness": [ /* three leave-a-week-out reruns with their own verdicts */ ],
      "vehicle": { "make": "Tesla", "model": "Model 3", "year": 2023, "city": "…",
                   "rating": 4.9, "trips": 112, "allStar": true, "image": "…", "url": "…" }
    } ]
  } ]
}

$ curl -s "https://carconomics.com/api/picks?group=tesla&market=ord" \
    | jq '{status, top: .markets[0].rows[0] | {listingId, score, rank, topValuePick}}'
{ "status": "ok", "top": { "listingId": "1543210", "score": 41, "rank": 1, "topValuePick": true } }

{
  "formulaVersion": "quant-stats-1.0",
  "status":         "ok",              // or "collecting" + reason before the first verified publication
  "group": "tesla", "market": "ord", "rentalDays": 3,
  "contentId": "…", "generationId": "…", "observedThrough": "<ISO timestamp>",
  "support": { "tier": "supported",    // supported ≥30 listings · thin 10–29 · unavailable <10 or <95% fresh
               "listings": 236, "freshListings": 234, "freshShare": 0.99, "reason": "…" },
  "current": {
    "selectedDuration":  { "medianPerDay": 52, "p10": 38, "p50": 52, "p90": 84,
                           "listings": 236, "ciLo": 49, "ciHi": 55, "complete": true },
    "durationCurve":     [ /* listing-equal median $/day per exact length */ ],
    "crossMarketPriceGap": [ /* same-model ORD vs LAX medians, each with its own interval */ ],
    "allStarShare":      { /* separately gated badge share + price comparison */ },
    "listingEqualCapturedDiscount": { /* p25/p50/p75 of captured host discounts */ }
  },
  "history": {
    "selectedDurationStatus": { "state": "ready", "completeDays": 21, "requiredDays": 14 },
    "selectedDuration":       [ /* daily p10/p50/p90 for this exact duration */ ],
    "repricingStatus":        { "state": "collecting", "requiredQualifyingDays": 28, "lookbackDays": 90 },
    "marketIndexStatus":      { "state": "ready", "supportedPoints": 34, "formulaVersion": "…" },
    "marketIndex":            [ /* same-listing daily index chain, reasons included */ ]
  },
  "definitions": { "quoteWindow": "…", "support": "…" }   // the vocabulary, in the payload itself
}

$ curl -s "https://carconomics.com/api/quant/stats?group=tesla&market=ord&length=3" \
    | jq '{status, tier: .support.tier, medianPerDay: .current.selectedDuration.medianPerDay}'
{ "status": "ok", "tier": "supported", "medianPerDay": 52 }

{
  "status":       "ok",               // or "untracked" — this id is not in the current snapshot
  "group":        "tesla",
  "contentId":    "…", "generationId": "…",
  "listingId":    "1543210",
  "market":       "ord",
  "urlBase":      "https://turo.com/…",
  "windowStart":  "<ISO date>",       // UNclamped market window start — the offset base
  "windowDays":   60,
  "supportedLengths": [1, …, 14],
  "failedOffsets": [17],              // pickup dates the collection could not verify — disclosed, not smoothed
  "capHits":      0,
  "observedThrough": "<ISO timestamp>",
  "staleMinutes": 24,
  "pricingValidated": false,          // false = price-only calendar; fair/save are 0
  "todayISO":     "<market-local today>",  // request-time; cells before it render as the no-claim past band
  "cells": [
    // [dayOffset, days, price, carried, fair, save] — one tuple per observed cell
    [12, 3, 141, 0, 0, 0],
    [12, 7, 289, 0, 0, 0],
    [13, 3, 150, 1, 0, 0]             // carried=1: last-seen price, not fresh this refresh
  ]
}

$ curl -s "https://carconomics.com/api/listing-calendar?listing=1543210" \
    | jq '{status, windowDays, cells: .cells | length, pricingValidated}'
{ "status": "ok", "windowDays": 60, "cells": 412, "pricingValidated": false }

// /api/preview-search
{ "status": "ok", "marketId": "nyc", "observedAt": "<ISO timestamp>", "staleMinutes": 41,
  "sampled": { "capHits": 3, "capped": true },   // the sample publishes WITH page-cap hits
  "bounds": { "minDate": "…", "maxDate": "…" },
  "query": { /* echo */ }, "results": [ /* ≤40 cards */ ],
  "totalMatches": 96, "totalOptions": 5210, "totalCars": 129, "pageSize": 40 }

// /api/preview-listing
{ "status": "ok", "listingId": "…", "windowStart": "<ISO date>", "windowDays": 60,
  "lengths": [1, …, 14], "urlBase": "https://turo.com/…",
  "cells": [ [12, 3, 141], … ] }     // [dayOffset, days, price] — no carried/fair tuple slots

// either endpoint, any failure
{ "status": "pending" }              // best-effort surface; it never 500s the planner

{
  "source":          "live",           // "empty" = no publication yet
  "group":           "tesla",
  "contentId":       "…",
  "generationId":    "…",
  "checkedAt":       "<ISO timestamp>",
  "publishedAt":     "<ISO timestamp>",
  "observedThrough": "<ISO timestamp>",
  "drops": [ {                         // ≤12, listing-level, expire after 48h
    "listingId": "1543210", "market": "ord", "model": "Model 3", "year": 2023,
    "startDate": "<ISO date>", "rentalDays": 3,
    "oldPrice": 178, "newPrice": 141, "pct": 0.21,
    "droppedAt": "<ISO timestamp>", "city": "…", "image": "…", "url": "…"
  } ]
}

$ curl -s "https://carconomics.com/api/dashboard-context?group=tesla" \
    | jq '{source, observedThrough, drops: .drops | length}'
{ "source": "live", "observedThrough": "<ISO timestamp>", "drops": 12 }

observedThrough / checkedAt = when the prices were actually observed
publishedAt                 = when this exact artifact was committed
staleMinutes                = minutes since the observation, not the HTTP response
snapshotId / contentId      = immutable — same id ⇒ byte-identical evidence
generationId                = the collection generation behind the content

browser        = every JSON response is Cache-Control: no-store
edge (search)  = first-page GETs (no cursor/offset, no location params)
                 keep a 45s shared copy · X-Carconomics-Cache: HIT|MISS|BYPASS
edge (context) = /api/dashboard-context keeps a 45s copy per group
origin         = ~10-minute in-memory snapshot memo per group behind every read
keys           = none required today · no rate-limit headers are sent