Prisradar
Primi passi

Primi passi con l’API di Prisradar

L’API di Prisradar restituisce per un’auto il valore di mercato in franchi, con forbice, affidabilità e numero di annunci comparabili. Funziona con qualsiasi linguaggio di programmazione in grado di inviare una richiesta HTTPS.

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"
  }'
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"
}

Come arrivo alla prima valutazione?

In quattro passi: creare un account, ottenere una chiave di test nella console, inviare la prima richiesta a /v1/valuations e leggere la risposta. Con la chiave di test non costa nulla. Appena il Suo software funziona, sceglie e paga un pacchetto nella console e crea una chiave live con valori reali.

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

  1. 1Creare l’accountAlla pagina Crea un account con ditta, nome, e-mail e password. Conferma l’e-mail con un clic; l’accesso con codice può attivarlo in seguito.
  2. 2Ottenere una chiave di testNella console, in «Chiavi». Le chiavi di test iniziano con pr_test_ e restituiscono valori d’esempio fissi.
  3. 3Inviare la richiestaInviare la chiave nell’header Authorization: Bearer … e l’auto come JSON.
  4. 4Leggere la rispostavalue.chf è il valore di mercato, low e high la forbice, confidence.level l’affidabilità.

Quali dati servono per una valutazione?

Sono obbligatori sei dati: marca, modello, anno della prima immatricolazione, chilometraggio, carburante e cambio. Potenza, trazione, carrozzeria, venditore e stato sono facoltativi e rendono il valore più preciso. Marca e modello può scriverli come li conosce il Suo software; l’API trova la grafia nel catalogo.

Tutti i campi sono descritti in Valutazione. La descrizione leggibile da macchina dell’intera API è disponibile come file OpenAPI; maggiori informazioni sul formato su openapis.org.

In che formato risponde l’API?

L’API risponde in JSON con codifica UTF-8. Gli importi sono in franchi interi IVA inclusa, arrotondati a 100, per esempio 34600. I chilometri sono numeri interi, gli orari seguono ISO 8601 in UTC. I nomi dei campi sono in inglese, messaggi e avvertenze in tedesco, così può mostrarli direttamente.

Solo dal server.Interroghi l’API dal Suo server, mai direttamente da un’app o da un sito web. Altrimenti la Sua chiave è visibile a tutti. La salvi in una variabile d’ambiente, mai fissa nel codice.

Cosa non può fare l’API?

L’API non valuta tramite numero di telaio o certificato del tipo, perché per questo servono dati con licenza. Non conosce la dotazione nel dettaglio; il valore vale per un’auto con dotazione media. Non fornisce annunci, foto né dati dei venditori, e le auto con più di 25 anni non ricevono un valore.

Prezzi d’offerta, non prezzi di vendita.Il valore si basa su annunci svizzeri attuali. A quanto un’auto sia stata venduta alla fine, non lo sa nessuno.

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