Endpunkte

Bewertung: den Marktwert eines Autos abfragen

Die Bewertung ist die wichtigste Abfrage der API. Sie schicken die Angaben zu einem Auto und bekommen den Marktwert in Franken, die Spanne und wie sicher der Wert ist. Auf Wunsch auch, wie viele Autos desselben Modells gerade inseriert sind.

Aktualisiert am 21.10.2026Prisradar Team

Auf dieser Seite

Welche Angaben schicke ich?
Was steht in der Antwort?
Wie lese ich die Sicherheit?
Was passiert, wenn es keinen Wert gibt?

curl -X POST https://prisradar.ch/api/v1/valuations \
  -H "Authorization: Bearer $PRISRADAR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "make": "Audi",
    "model": "Q5",
    "year": 2021,
    "mileageKm": 50000,
    "fuel": "diesel",
    "transmission": "automatic",
    "powerKw": 140,
    "drive": "awd",
    "include": [
      "market"
    ]
  }'

Antwort 200

{
  "id": "val_kglReIcl8Sw0",
  "test": false,
  "vehicle": {
    "make": "Audi",
    "model": "Q5",
    "year": 2021,
    "mileageKm": 50000,
    "fuel": "diesel",
    "transmission": "automatic"
  },
  "value": {
    "chf": 34600,
    "low": 28400,
    "high": 42100,
    "basis": "asking_prices"
  },
  "confidence": {
    "level": "hoch",
    "score": 0.84
  },
  "comparables": {
    "count": 10,
    "closeness": "eng",
    "level": "configuration"
  },
  "notes": [],
  "attribution": {
    "text": "Preisorientierung von prisradar.ch",
    "url": "https://prisradar.ch"
  },
  "dataAsOf": "2026-10-13T00:21:50.494Z",
  "market": {
    "activeListings": 1269,
    "medianDaysOnline": 48
  }
}

Welche Angaben schicke ich?

Pflicht sind make, model, year, mileageKm, fuel und transmission. Freiwillig sind Leistung, Antrieb, Karosserie, Verkäufer und Zustand. Je mehr Angaben, desto enger passen die Vergleichsinserate und desto sicherer der Wert. Ohne Angabe zum Verkäufer rechnet die API mit einem Händler. Freiwillige Felder dürfen fehlen oder null sein.

POSThttps://prisradar.ch/api/v1/valuations

Feld	Typ	Bedeutung
`make`Pflicht	string	Marke, in beliebiger Schreibweise: `Audi`, `Mercedes-Benz`, `VW`.
`model`Pflicht	string	Modell wie im Katalog, zum Beispiel `Q5` oder `Golf`.
`year`Pflicht	integer	Jahr der Erstzulassung. Autos älter als 25 Jahre bekommen keinen Wert.
`mileageKm`Pflicht	integer	Kilometerstand, 0 bis 999999.
`fuel`Pflicht	enum	`petrol` `diesel` `hybrid` `electric` `gas`
`transmission`Pflicht	enum	`manual` `automatic`
`powerKw`	integer	Leistung in kW. Alternativ `powerHp` in PS.
`drive`	enum	`fwd` `rwd` `awd`
`bodyType`	enum	`small` `sedan` `wagon` `suv` `coupe` `convertible` `van`
`seller`	enum	`dealer` oder `private`. Ohne Angabe: Händler.
`condition.accident`	boolean	Unfallfahrzeug: Der Wert und die Sicherheit sinken; `notes` nennt den Abzug.
`condition.damage`	boolean	Sichtbarer Schaden: Der Wert sinkt; `notes` nennt den Abzug.
`include`	array	`["market"]` liefert `market` mit.

Was steht in der Antwort?

value.chf ist der Marktwert in Franken, value.low und value.high die Spanne, in der die meisten vergleichbaren Angebote liegen. confidence sagt, wie sicher der Wert ist, comparables, wie viele Inserate ihn stützen. notes enthält Hinweise auf Deutsch, attribution den Text und Link, die beim Wert stehen müssen.

Feld	Typ	Bedeutung
`value.chf`	integer	Marktwert in Franken, auf 100 gerundet.
`value.low · value.high`	integer	Spanne, in der die meisten vergleichbaren Angebote liegen.
`value.basis`	string	Immer `asking_prices`: Angebotspreise aus Inseraten.
`confidence.level`	enum	`hoch` ab 0.7, `mittel` ab 0.5, sonst `tief`. Dazu `score` von 0 bis 1.
`comparables.count`	integer	Wie viele ähnliche Inserate den Wert stützen, mindestens 3.
`comparables.closeness`	enum	`eng`: alle nah am Auto. `weit`: der Kreis musste weiter werden.
`comparables.level`	enum	`configuration`: gleicher Treibstoff und Getriebe. `model`: das ganze Modell.
`market`	object	Nur mit `include`: `activeListings` gerade inseriert, `medianDaysOnline` mittlere Standzeit in Tagen.
`notes`	string[]	Hinweise auf Deutsch, zum Beispiel zu einem Abzug für einen Unfall.
`attribution`	object	Text und Link, die beim Wert stehen müssen.
`dataAsOf`	string	Wann die Preise der Vergleichsinserate zuletzt neu berechnet wurden.

Wie lese ich die Sicherheit?

confidence.level fasst zusammen, wie gut der Wert gestützt ist: hoch, mittel oder tief. Er hängt davon ab, wie viele Vergleichsinserate es gibt und wie nah sie am Auto sind. Zeigen Sie bei tief einen Hinweis neben dem Wert oder lassen Sie ihn weg, je nachdem, wofür Ihre Software ihn braucht.

Was passiert, wenn es keinen Wert gibt?

Kennt der Katalog die Marke oder das Modell nicht, kommt 404 mit Vorschlägen in error.suggestions. Gibt es zu wenige ähnliche Inserate, kommt 422 too_few_comparables; das ist kein Fehler Ihrer Software, seltene Autos haben oft zu wenige Vergleiche. Beides zählt nicht zum Kontingent.

Antwort 404

{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}

Antwort 422

{
  "error": {
    "code": "too_few_comparables",
    "message": "Zu wenige ähnliche Inserate für einen sicheren Wert.",
    "comparables": {
      "count": 2,
      "needed": 3
    }
  }
}

Nicht gefunden, was Sie suchen?Schreiben Sie an info@prisradar.ch oder über das Kontaktformular.