Developer Documentation

AutoSpec REST API v1

High-performance JSON API providing access to complete automotive technical specifications, dynamic metric and imperial conversions, and VIN decoding. Built on native PHP 8.4 with sub-millisecond response latency.

Base URL


                https://mail.web-nusa.site/api/v1

Public Demo Key


                autospec-demo-key-2026

Content Type & CORS

application/json; charset=utf-8
Access-Control-Allow-Origin: *

Authentication Methods

AutoSpec API supports 3 flexible authentication mechanisms. You can pass your credentials via HTTP headers or URL query parameters:

Header X-API-Key: <your_api_key>

Recommended for backend microservices and server-side applications.

Query Parameter ?api_key=<your_api_key>

Convenient for browser queries, image lookups, and rapid debugging.

RapidAPI Proxy X-RapidAPI-Proxy-Secret: <secret>

Automated verification when consuming AutoSpec via RapidAPI Marketplace.

Endpoints Reference

GET /api/v1/status

Try in browser →

Returns platform operational health, PHP 8.4 engine runtime details, and real-time database record counts.

{ "success": true, "timestamp": "2026-11-14T23:30:00Z", "data": { "status": "operational", "version": "1.0.0", "php_version": "8.4.x", "database_stats": { "makes_count": 82, "models_count": 415, "generations_count": 680, "trims_count": 1362 } } }

GET /api/v1/makes

Try in browser →

Retrieve all automakers. Supports filtering by country, popular status, and search string.

Query params: ?country=Germany • ?popular=true • ?search=BMW

GET /api/v1/models

Try in browser →

Retrieve car models grouped by automaker.

Query params: ?make=porsche • ?vehicle_type=Sedan • ?search=Cayenne

GET /api/v1/trims (Alias: /api/v1/specs)

Try in browser →

Full paginated query engine for car trims with dynamic metric/imperial unit formatting.

?q= search keyword

?unit= metric | imperial

?make= automaker slug/id

?model= model slug/id

?year= exact year

?min_year= / ?max_year= range

?fuel_type= gasoline / electric / etc

?body_type= coupe / sedan / suv / etc

?drivetrain= awd / rwd / fwd

?sort= hp_desc, accel_asc, top_speed_desc, year_desc

?page= & ?limit= pagination (max 100)

GET /api/v1/compare?trims=slug1,slug2&unit=metric

Pass 2 to 4 comma-separated vehicle slugs or IDs to receive unified side-by-side spec objects.

GET /api/v1/vin/{vin}

Try in browser →

Decode any standard 17-character VIN with NHTSA vPIC online engine + local ISO-3779 WMI fallback and database trim matches.

Integration Examples

cURL

curl -X GET "https://mail.web-nusa.site/api/v1/trims?limit=5&unit=metric" \ -H "X-API-Key: autospec-demo-key-2026" \ -H "Accept: application/json"

JavaScript (Fetch)

const res = await fetch('https://mail.web-nusa.site/api/v1/trims?limit=5', { headers: { 'X-API-Key': 'autospec-demo-key-2026', 'Accept': 'application/json' } }); const data = await res.json(); console.log(data.data);

PHP 8.4

$ch = curl_init('https://mail.web-nusa.site/api/v1/trims?limit=5'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: autospec-demo-key-2026'], ]); $response = json_decode(curl_exec($ch), true);

Python

import requests url = "https://mail.web-nusa.site/api/v1/trims?limit=5" headers = {"X-API-Key": "autospec-demo-key-2026"} resp = requests.get(url, headers=headers) specs = resp.json()["data"]