Developer

Public API

A JSON API that mirrors the chiptuning catalog hierarchy: Vehicle Type → Brand → Model → Generation → Engine → Tuning File. Currently indexing 337 brands and 908 tuning files.

basehttps://dynovault.net/api
01

Authentication

All catalog endpoints are public — no auth required for casual exploration. To unlock higher rate limits and usage tracking, send an API key in the X-API-Key header (or as ?api_key= query param). Keys are minted from the admin dashboard.

curl -H "X-API-Key: dv_xxxxxxxxxxxxxxxx" https://dynovault.net/api/stats

Per-key minting

Admin creates labeled keys with a per-minute rate limit.

Sliding window

Rate-limited at the minute granularity; 429 on overflow.

Anonymous OK

Endpoints work without a key — limits apply only when one is sent.

02

Endpoints

GET
/api/vehicle-types

List all vehicle classes (cars, trucks, motos, quads, jetski, agricultures, construction-machines, bus).

GET
/api/vehicle-types/{slug}/brands

Brands within a vehicle type.

GET
/api/brands/{brandId}/models

Models for a brand.

GET
/api/models/{modelId}/generations

Generations (year-ranges, chassis codes) for a model.

GET
/api/generations/{generationId}/engines

Engine variants for a generation (stock_power_hp, fuel_type, displacement).

GET
/api/tuning-files/{engineId}

Stock vs Tuned HP/Nm, tuning options, supported ECUs, vehicle image, source URL.

GET
/api/search?q=audi+a3+2.0+tdi

Cross-hierarchy AND-search across brand, model, generation, engine.

GET
/api/stats

Document counts for each level of the catalog.

03

Quick start

curl

# List car brands
curl https://dynovault.net/api/vehicle-types/cars/brands

# Search for a specific engine
curl "https://dynovault.net/api/search?q=audi+a3+2.0+tdi+150hp"

# Fetch full tuning file by engine id
curl https://dynovault.net/api/tuning-files/<engineId>

node / fetch

const API_KEY = "dv_xxxxxxxxxxxxxxxx";
const res = await fetch("https://dynovault.net/api/search?q=bmw+m3", {
  headers: { "X-API-Key": API_KEY },
});
const { results } = await res.json();
console.log(results);

python / requests

import requests

base = "https://dynovault.net/api"
headers = {"X-API-Key": "dv_xxxxxxxxxxxxxxxx"}
brands = requests.get(f"{base}/vehicle-types/cars/brands", headers=headers).json()
for b in brands[:3]:
    print(b["name"], b["id"])
04

Sample response

GET /api/tuning-files/{engineId}

{
  "vehicle_type": "Cars",
  "brand": "Audi",
  "model": "A3",
  "generation": "8V Mk1 | 2012 > 2016",
  "year_from": 2012,
  "year_to": 2016,
  "engine": "2.0 TDI CR 150hp",
  "engine_fuel_type": "diesel",
  "stock_power_hp": 150,
  "tuned_power_hp": 185,
  "power_gain_hp": 35,
  "stock_torque_nm": 320,
  "tuned_torque_nm": 410,
  "torque_gain_nm": 90,
  "tuning_method": "Chiptuning",
  "tuning_options": ["Chiptuning (stage1)", "DPF remove", "EGR removing", ...],
  "ecu_types": ["TEMIC DQ250", "BOSCH EDC17C64", ...],
  "image_url": "https://www.modfiles.net/uploads/tuningfiles/thumbs/...jpg",
  "source_url": "https://www.mod-files.com/tuning-file-v2/cars/audi/a3/2012-2016/tdi-cr/2-0/150hp/"
}
06

Plans & pricing

API keys start on the free tier. Top up with prepaid credits — each top-up resets your billing cycle and unlocks a higher rate-limit ceiling. Test-mode Stripe Checkout for now.

Get this from /admin

Free

$0.00/cycle

  • 1,000 requests / month
  • 60 req/min
  • Community support

Starter

$9.99/cycle

  • 10,000 requests / month
  • 120 req/min
  • Email support

Pro

$39.99/cycle

  • 100,000 requests / month
  • 300 req/min
  • Priority support

Scale

$99.99/cycle

  • 500,000 requests / month
  • 600 req/min
  • SLA + dedicated support
07

Invoice history

Paste your API Key ID below to see every payment + the credits it applied. No login required — possessing the key ID is the auth.

08

Interactive Swagger / OpenAPI

Every endpoint is also browsable in our hosted Swagger UI (FastAPI auto-generated from the source types):

Open /docs

Made with Emergent