The Dealer Public API is the stable, read-only contract for custom dealer frontends and server-side integrations. It exposes dealer inventory, NLT offers, and DealerMAX-generated content through apimax, the read-only public plane of DealerMAX.

Canonical contract

Inventory endpoints

Inventory parameters

For /dealer/{service}/details, pass exactly one identifier: id_auto for REWIND/NOS, or id_offerta for NLT.

Services

• REWIND - used vehicles for sale.
• NOS - used vehicles for rent without scoring.
• NLT - long-term rental offers.

Previous-owner count provenance

Used-vehicle listing and detail responses expose previous_owner_count, previous_owner_count_source, and previous_owner_count_is_fallback. For missing, null, or legacy-zero used-stock values, the Core contract stores and returns previous_owner_count: 1 with source default_fallback and previous_owner_count_is_fallback: true.

A fallback value is a technical default, not evidence that the vehicle had one verified previous owner. A frontend may label it Valore predefinito, but must not create a Unico proprietario badge or quality or promotional claim from it. Clients should use the source or boolean, not the numeric value alone, when deciding whether an owner-count claim is appropriate.

This is an additive response contract enabled after the coordinated Core rollout. Until that rollout is live, clients must tolerate these new fields being absent and treat their absence as unknown. This contract does not initiate a new ownership lookup.

Content endpoints

Content parameters

Content types

• faq - dealer FAQ with overrides and hidden items respected.
• news - dealer custom news and configured DealerMAX news rewrites.
• glossary - automotive terms and definitions.
• guides - long-form DealerMAX guides.
• videos - generated dealer vehicle videos.
• podcasts - generated vehicle podcast episodes with audio and transcript.

Response examples

All successful listing endpoints return a stable pagination envelope: page, page_size, total, has_next, and items.

Inventory listing

{
  "service": "REWIND",
  "page": 1,
  "page_size": 20,
  "total": 1,
  "has_next": false,
  "items": [
    {
      "id_auto": "4f2f1c2d-8c3b-4f8d-9f6b-6a9a8d1e2b10",
      "marca": "FIAT",
      "modello": "500",
      "prezzo_vendita": 12900.0,
      "previous_owner_count": 1,
      "previous_owner_count_source": "default_fallback",
      "previous_owner_count_is_fallback": true,
      "cover_url": "https://cdn.example.com/vehicles/fiat-500.jpg",
      "has_podcast": false,
      "has_video": false,
      "service": "REWIND"
    }
  ]
}

Inventory details

{
  "service": "REWIND",
  "vehicle": {
    "id_auto": "4f2f1c2d-8c3b-4f8d-9f6b-6a9a8d1e2b10",
    "marca": "FIAT",
    "modello": "500",
    "previous_owner_count": 1,
    "previous_owner_count_source": "default_fallback",
    "previous_owner_count_is_fallback": true,
    "ai_content": {
      "description_short": "City car compatta e pronta consegna"
    },
    "media_urls": ["https://cdn.example.com/vehicles/fiat-500.jpg"],
    "has_podcast": true,
    "has_video": false
  }
}

{
  "service": "NLT",
  "offer": {
    "id_offerta": 12345,
    "marca": "FIAT",
    "modello": "Panda",
    "quotazioni": [
      {
        "months": 36,
        "km_per_year": 10000,
        "monthly_fee": 299.0
      }
    ]
  }
}

Content listing

{
  "content_type": "guides",
  "page": 1,
  "page_size": 10,
  "total": 1,
  "has_next": false,
  "q": "garanzia",
  "filters": {
    "topic": "garanzia"
  },
  "meta": {
    "dealer": {
      "id": 42,
      "name": "DealerMAX Demo",
      "primary_domain": "demo.dealermax.app"
    }
  },
  "items": [
    {
      "id": 101,
      "slug": "garanzia-auto-usata",
      "title": "Garanzia auto usata",
      "excerpt": "Cosa controllare prima di acquistare...",
      "url": "/guide/garanzia-auto-usata",
      "updated_at": "2026-06-25T10:00:00+00:00"
    }
  ]
}

Content details and search

{
  "content_type": "guides",
  "item": {
    "slug": "garanzia-auto-usata",
    "title": "Garanzia auto usata",
    "body_text": "Testo completo della guida..."
  },
  "meta": {
    "dealer": {
      "id": 42,
      "name": "DealerMAX Demo"
    }
  }
}

{
  "q": "garanzia",
  "page_size_per_type": 5,
  "total": 3,
  "by_type": {
    "faq": 1,
    "guides": 2
  },
  "items": [
    {
      "content_type": "guides",
      "slug": "garanzia-auto-usata",
      "title": "Garanzia auto usata"
    }
  ]
}

Public boundary

The public developer contract intentionally exposes only dealer-ready resources. It does not expose upstream lookup cascades, source identifiers, raw technical-data directories, browser-side secrets, or internal SSR/SEO payloads.