Autenticazione
Tutte le richieste richiedono un header Authorization con Bearer token:
Authorization: Bearer brumiq_live_YOUR_API_KEYIn alternativa: ?api_key=brumiq_live_...
Crediti
Ogni chiamata consuma 1 credito se la targa non è nella cache. Le targhe già presenti sono gratuite. I crediti non scadono mai.
Header risposta: X-Credits-Remaining · X-Cache: HIT|MISS
Endpoints
GET
/api/v1/vehicle/{plate}Dati completi per una targaPOST
/api/v1/batchDati per fino a 50 targhePOST
/api/v1/keysCrea una nuova API keyPOST
/api/v1/credits/checkoutCheckout Stripe per comprare creditiOpenAPI (Reports)
Specifica OpenAPI 3.1 per gli endpoint report. Importabile direttamente in Swagger UI, Postman e Insomnia.
https://brumiq.com/api/docs/openapiEsempio risposta — GET /api/v1/vehicle/{plate}
{
"object": "vehicle",
"plate": "AB123CD",
"data": { "make": "Volkswagen", "model": "Golf", "year": 2019, "fuelType": "Benzina" },
"brumiq": {
"score": { "grade": "B", "numeric": 72 },
"marketValue": { "estimated": 18500, "currency": "EUR" },
"ownership": { "count": 2 },
"mileage": { "last": 87000, "unit": "km" },
"anomalyFlags": [{ "type": "price_drop", "message": "Prezzo calato del 18%", "severity": "medium" }],
"searchCount": 7,
"lastUpdated": "2026-03-10T14:22:00Z",
"cacheHit": true
},
"meta": { "version": "v1", "timestamp": "2026-03-12T10:00:00Z", "docs": "https://brumiq.com/api-docs" }
}Rate limit
Default: 100 chiamate/ora per API key. Per limiti più alti: api@brumiq.com.
Piani API
Starter
€79
una tantum
100 call
Business
€299
una tantum
500 call
Enterprise
€999
una tantum
2.000 call
Enterprise+
€3.999
una tantum
10.000 call