# AutoPulse

> Automotive intelligence API with global recall coverage. Safety recall lookup by VIN using NHTSA (US), DVSA (UK), Transport Canada, ACCC (Australia), RAPEX (EU), and MLIT (Japan) — plus reliability analysis, DIY repair guides, vehicle comparison, and market value. Works for any vehicle sold in any market. Pay-per-query via x402 micropayments on Base mainnet.

## Endpoints

GET /api/auto/recall?vin={VIN}
- Returns: active recalls with plain-English risk levels (critical/high/medium/low), what fails, consequences, remedy, and exact action for the owner
- Data: NHTSA (US) + international databases — DVSA (UK), Transport Canada, ACCC (Australia), RAPEX (EU), MLIT (Japan)
- Alternative: use year + make + model instead of VIN
- Works for any vehicle in any market (Toyota, BMW, Honda, Kia, etc.)
- Optional: lang
- Price: $0.05

GET /api/auto/problems?year={year}&make={make}&model={model}
- Returns: reliability verdict, known problems ranked by severity and frequency, typical mileage when problems appear, repair costs, DIY feasibility, NHTSA complaint summary
- Optional: lang
- Price: $0.10

GET /api/auto/repair?vehicle={vehicle}&job={job}
- Returns: difficulty rating (beginner/intermediate/advanced/shop_only), time and cost estimate (DIY vs shop), parts list with Amazon links, tools needed, step-by-step instructions, safety warnings
- Optional: lang
- Price: $0.10

GET /api/auto/compare?vehicles={vehicle1,vehicle2,...}
- Returns: side-by-side reliability, EPA combined MPG, 5-year ownership cost estimate, strengths/weaknesses, head-to-head category winners, overall winner with reasoning
- Optional: year, lang (up to 4 vehicles)
- Price: $0.10

GET /api/auto/value?vin={VIN}&mileage={miles}
- Returns: private party, dealer trade-in, and dealer retail price ranges, sell vs. hold recommendation, depreciation context, tips to maximize sale value, best platforms to sell
- Alternative: use year + make + model instead of VIN
- Optional: condition (excellent | good | fair | poor), lang
- Price: $0.08

## Payment

All endpoints use x402 protocol. No payment header → HTTP 402 with PAYMENT-REQUIRED header (0.05–0.10 USDC on Base mainnet). Send valid PAYMENT-SIGNATURE → 200 with structured JSON.

## Data Sources

- NHTSA API (api.nhtsa.dot.gov) — official recall data and consumer complaints, free, no key required
- EPA Fuel Economy API (fueleconomy.gov) — official MPG data for every vehicle, free, no key required
- Tavily — real-time owner forums, repair guides, market pricing
- Claude Sonnet — synthesis and plain-English interpretation

## Affiliate Disclosure

Repair and parts responses include Amazon affiliate links (tag: pulsenetwork7-20) for recommended parts and tools.

## Disclaimer

For informational purposes only. Always consult a qualified mechanic for safety-critical repairs and decisions.