Prisradar
Endpoint

Valutazione: richiedere il valore di mercato di un’auto

La valutazione è la richiesta più importante dell’API. Invia i dati di un’auto e riceve il valore di mercato in franchi, la forbice e quanto è affidabile il valore. Se lo desidera, anche quante auto dello stesso modello sono in vendita in questo momento.

Aggiornato il 21.10.2026Il team Prisradar

In questa pagina
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"
    ]
  }'
Risposta 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
  }
}

Quali dati invio?

Sono obbligatori make, model, year, mileageKm, fuel e transmission. Sono facoltativi potenza, trazione, carrozzeria, venditore e stato. Più dati invia, più gli annunci comparabili sono vicini e più il valore è affidabile. Senza indicazione sul venditore, l’API calcola con un commerciante. I campi facoltativi possono mancare o essere null.

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

CampoTipoSignificato
makeObbligatoriostringMarca, in qualsiasi grafia: Audi, Mercedes-Benz, VW.
modelObbligatoriostringModello come nel catalogo, per esempio Q5 o Golf.
yearObbligatoriointegerAnno della prima immatricolazione. Le auto con più di 25 anni non ricevono un valore.
mileageKmObbligatoriointegerChilometraggio, da 0 a 999999.
fuelObbligatorioenumpetrol diesel hybrid electric gas
transmissionObbligatorioenummanual automatic
powerKwintegerPotenza in kW. In alternativa powerHp in CV.
driveenumfwd rwd awd
bodyTypeenumsmall sedan wagon suv coupe convertible van
sellerenumdealer o private. Senza indicazione: commerciante.
condition.accidentbooleanVeicolo incidentato: il valore e l’affidabilità scendono; notes indica la deduzione.
condition.damagebooleanDanno visibile: il valore scende; notes indica la deduzione.
includearray["market"] fornisce anche market.

Cosa c’è nella risposta?

value.chf è il valore di mercato in franchi, value.low e value.high la forbice in cui si trova la maggior parte delle offerte comparabili. confidence dice quanto è affidabile il valore, comparables quanti annunci lo sostengono. notes contiene avvertenze in tedesco, attribution il testo e il link che devono figurare accanto al valore.

CampoTipoSignificato
value.chfintegerValore di mercato in franchi, arrotondato a 100.
value.low · value.highintegerForbice in cui si trova la maggior parte delle offerte comparabili.
value.basisstringSempre asking_prices: prezzi d’offerta degli annunci.
confidence.levelenumhoch (alta) da 0.7, mittel (media) da 0.5, altrimenti tief (bassa). In più score da 0 a 1.
comparables.countintegerQuanti annunci simili sostengono il valore, almeno 3.
comparables.closenessenumeng (stretta): tutti vicini all’auto. weit (ampia): la cerchia ha dovuto allargarsi.
comparables.levelenumconfiguration: stesso carburante e stesso cambio. model: l’intero modello.
marketobjectSolo con include: activeListings in vendita in questo momento, medianDaysOnline giorni online medi.
notesstring[]Avvertenze in tedesco, per esempio su una deduzione per un incidente.
attributionobjectTesto e link che devono figurare accanto al valore.
dataAsOfstringQuando i prezzi degli annunci comparabili sono stati ricalcolati l’ultima volta.

Come leggo l’affidabilità?

confidence.level riassume quanto è sostenuto il valore: hoch, mittel o tief, cioè alta, media o bassa. Dipende da quanti annunci comparabili ci sono e da quanto sono vicini all’auto. Con tief mostri un’avvertenza accanto al valore oppure lo ometta, a seconda di ciò per cui il Suo software lo usa.

Cosa succede se non c’è un valore?

Se il catalogo non conosce la marca o il modello, arriva 404 con proposte in error.suggestions. Se ci sono troppo pochi annunci simili, arriva 422 too_few_comparables; non è un errore del Suo software, le auto rare hanno spesso troppo pochi confronti. In entrambi i casi la richiesta non conta nel contingente.

Risposta 404
{
  "error": {
    "code": "unknown_make",
    "message": "Die Marke «Ferari» kennen wir nicht.",
    "suggestions": [
      "Ferrari"
    ]
  }
}
Risposta 422
{
  "error": {
    "code": "too_few_comparables",
    "message": "Zu wenige ähnliche Inserate für einen sicheren Wert.",
    "comparables": {
      "count": 2,
      "needed": 3
    }
  }
}

Non ha trovato ciò che cerca?Scriva a info@prisradar.ch o tramite il modulo di contatto.

Digiti ciò che cerca: una funzione, una domanda o un codice d’errore.

↑ ↓ seleziona↵ apriEsc chiudi