# TruckRadar.ai

> AI-powered heavy-duty (Class 5–8) truck and trailer search engine and inventory
> aggregation platform. Sub-50ms search across normalized dealer inventory, with
> Claude-powered natural-language query parsing. Also serves trailerradar.ai.

## Buyer

- [Search](https://truckradar.ai/search): AI + faceted search across every active listing
- [Dealer directory](https://truckradar.ai/dealers): Every verified dealer, by state and city
- [Buying guide](https://truckradar.ai/buying-guide): Class 5–8 truck buying primer
- [Pricing (subscriptions)](https://truckradar.ai/pricing): Dealer plans and feature matrix
- [CDL requirements](https://truckradar.ai/cdl/requirements): State-by-state CDL rules
- [CDL schools by state](https://truckradar.ai/cdl/schools): 30,000+ FMCSA-approved CDL training locations in all 50 states
- [Weight limits](https://truckradar.ai/regulations/weight-limits): Federal and state GVWR / GCWR
- [Hours of service](https://truckradar.ai/regulations/hours-of-service): FMCSA HOS reference
- [IFTA fuel tax](https://truckradar.ai/regulations/ifta): IFTA primer and quarterly filing
- [FMCSA carrier lookup](https://truckradar.ai/carrier/search): Search DOT / MC numbers
- [ZEV mandate tracker](https://truckradar.ai/regulations/zev-mandates): CARB ACF, multi-state Advanced Clean Trucks, EPA 2027 NOx rule timeline

## Market data

- [Diesel prices by state](https://truckradar.ai/market/diesel-prices): Weekly EIA on-highway diesel, national + PADD + 50 states
- [Freight Transportation Services Index](https://truckradar.ai/market/freight-index): Monthly BTS truck-freight subindex
- [Housing starts & truck demand](https://truckradar.ai/market/housing-starts): Monthly Census / FRED housing data with truckload implications
- [Trucking industry employment](https://truckradar.ai/market/trucking-employment): Monthly BLS / FRED employment for long-distance and local trucking
- [Class 8 orders](https://truckradar.ai/market/class-8-orders): Monthly ACT / FTR commentary on Class 8 net orders
- [Market outlook](https://truckradar.ai/market/outlook): Monthly composite Market Temperature across all indicators
- [Heavy truck finance calculator](https://truckradar.ai/market/finance-calculator): Full-featured monthly payment estimator (term, APR, down, trade, balloon, Section 179) also embedded on every listing
- [Fuel surcharge calculator](https://truckradar.ai/market/fuel-surcharge-calculator): Interactive tool for fleets to compute per-mile surcharges from weekly diesel prices
- [Used truck values](https://truckradar.ai/market/used-truck-values): How Class 8 backlog-to-build affects used-truck asking prices by class and make; sourced from active listing data
- [Contract rates](https://truckradar.ai/market/contract-rates): BLS PPI monthly for-hire long-distance TL and LTL contract pricing
- [ISM PMI](https://truckradar.ai/market/pmi): Manufacturing + Services PMI — leading indicators for truckable freight demand
- [Truck tonnage](https://truckradar.ai/market/truck-tonnage): ATA monthly Truck Tonnage Index (FRED mirror)
- [Consumer demand](https://truckradar.ai/market/consumer-demand): UMich Consumer Sentiment + retail sales ex-auto, cleanest reads on dry-van demand
- [Rail intermodal](https://truckradar.ai/market/rail-intermodal): Weekly AAR rail carloads + intermodal units (FRED mirror)
- [Cass Freight Index](https://truckradar.ai/market/cass-freight-index): Monthly shipments + expenditures index from Cass Information Systems
- [Logistics Managers' Index](https://truckradar.ai/market/logistics-managers-index): Monthly LMI diffusion index across transportation + warehousing
- [Port volumes](https://truckradar.ai/market/port-volumes): Loaded import TEUs at top 5 U.S. ports (LA, LB, NY/NJ, Savannah, Houston)
- [Inventory turn](https://truckradar.ai/market/inventory-turn): TruckRadar proprietary: days-on-lot, feed-disappearance rate, price-drop frequency by class + body + region
- [Spec trends](https://truckradar.ai/market/spec-trends): TruckRadar proprietary: engine, transmission, cab, axle share shifts by year
- [Carrier capacity](https://truckradar.ai/market/carrier-capacity): FMCSA monthly motor-carrier authority grants vs revocations, net capacity change
- [Driver supply](https://truckradar.ai/market/driver-supply): Quarterly FMCSA CDL issuances + ELDT completions
- [Driver wages by state](https://truckradar.ai/market/driver-wages): BLS OEWS mean and median wages for heavy truck drivers (SOC 53-3032) in all 50 states
- [Cost per mile calculator](https://truckradar.ai/market/cost-per-mile): Interactive Class 8 TCO calculator — fuel, driver wages, insurance, maintenance, truck payment
- [Fuel efficiency by truck](https://truckradar.ai/market/fuel-efficiency-by-truck): Real-world MPG ranges for Class 6–8 trucks by make, model, engine, and spec

## Dealer API and feeds

- [Dealer API overview](https://truckradar.ai/dealers/docs): REST API base URL, auth, versioning
- [Authentication](https://truckradar.ai/dealers/docs/auth): Bearer tokens, rotation, scoping
- [Inventory API](https://truckradar.ai/dealers/docs/inventory): POST / PATCH / GET endpoints and full field reference
- [Dealers API](https://truckradar.ai/dealers/docs/dealers): Upsert dealer + location records
- [Feed formats](https://truckradar.ai/dealers/docs/feed-formats): XML and CSV specs with annotated sample
- [Error codes](https://truckradar.ai/dealers/docs/errors): Every pipeline + API error code and fix
- [Rate limits](https://truckradar.ai/dealers/docs/rate-limits): Fair-use ceilings and backoff policy
- [Changelog](https://truckradar.ai/dealers/docs/changelog): Dated release history
- [OpenAPI 3.1 descriptor](https://truckradar.ai/api/v1/openapi.json): Machine-readable spec

## Company

- [Pricing](https://truckradar.ai/pricing): Dealer subscription tiers
- [Privacy](https://truckradar.ai/privacy): Privacy policy
- [Terms](https://truckradar.ai/terms): Terms of service

## [sources]

TruckRadar aggregates heavy-duty truck and trailer inventory from the following source types:

- **Live dealer feeds** — XML/CSV pulls via FTP, SFTP, or direct HTTP from dealership DMS systems (Karmak, IManPro, DealerSpike, BuzzNerd)
- **Direct API pushes** — dealers POST inventory to `/api/v1/inventory` via REST API
- **Scraper network** — 90+ dealer-authorized web scrapers maintained by TruckRadar (Playwright + HTTP)
- **Historical imports** — dealer-uploaded CSV of past listings for sales history reconstruction

Market data sourced from: EIA (diesel prices), BLS (employment, wages), BTS (freight index), Census/FRED (housing starts), FMCSA (carrier authority, CDL), ATA (truck tonnage), AAR (rail/intermodal), Cass Information Systems (freight index), ACT/FTR (Class 8 orders).

All pricing is **asking price** as listed by the dealer. TruckRadar does not report transaction prices, book values, or modeled valuations.

## [endpoints]

Public read endpoints (no auth required):
- `GET /api/v1/search` — search listings with filters or natural-language query
- `GET /api/v1/inventory/:vin` — look up current listing by VIN
- `GET /api/v1/dealers` — list dealers by state/city

Dealer write endpoints (Bearer API key required):
- `POST /api/v1/inventory` — ingest one or more listings through the full pipeline
- `PATCH /api/v1/inventory` — mark a listing delisted or update fields by VIN
- `POST /api/v1/dealers` — create dealer + locations (first sync only)
- `PATCH /api/v1/dealers` — update dealer scalar fields by slug
- `POST /api/v1/inventory/historical-import` — bulk CSV upload of historical listings (multipart/form-data)

## [content-policy]

TruckRadar content is factual and sourced from public dealer inventory and government datasets.

- Inventory listings reflect asking prices as listed by the dealer at the time of ingestion. Prices change; always check the listing URL for the current price.
- TruckRadar does not verify VINs against manufacturer records. VIN checksums are validated; pre-1981 trucks with non-standard serials may appear with `vin_checksum_failed` flagged internally.
- Market data pages cite the originating government or industry source on each page.
- AI-generated listing descriptions (where present) are factual summaries derived only from the listing's own fields — year, make, model, mileage, price, location. No adjectives are added; no valuations are implied.
- Truck listings may include vehicles that are no longer available. Status is updated at each scrape/feed cycle; check `last_synced_at` for freshness.
- This site does not contain transaction-level sold prices unless a dealer has explicitly entered them via the Mark Sold dashboard feature.

## [freshness]

- Dealer inventory: updated at each scraper cycle (typically daily per dealer) or at each feed push (live-feed dealers push changes within minutes of a DMS update)
- Market data pages: updated on each source's publication schedule — EIA diesel prices weekly, BLS employment monthly, ATA tonnage monthly, AAR rail carloads weekly
- `last_synced_at` is exposed on every listing — check this field to determine data age
- Listings may appear with `status: active` up to 24 hours after a vehicle sells, pending the next sync cycle

## [coverage]

- Trucks: Class 5–8 commercial trucks — sleeper, day cab, vocational, flatbed, dump, tanker, reefer, crane, mixer, tow, box, cab & chassis
- Trailers: All major trailer types on trailerradar.ai — dry van, reefer, flatbed, step deck, lowboy, dump, tanker, auto carrier, hopper, curtainside, double-drop, hopper
- Geography: United States only (all 50 states)
- Source types: live dealer feeds (XML/CSV via FTP/SFTP/HTTP), direct API pushes, and 90+ dealer-authorized scrapers
- Not covered: auction transaction prices, dealer-to-dealer (wholesale) prices, Canadian inventory, individual private seller listings

## [limitations]

- All prices are asking prices as listed by the dealer — not transaction prices, book values, or appraisals
- Inventory freshness varies by source: live-feed dealers update within minutes; scraper-sourced dealers update on a daily cycle
- VIN checksums are validated but VINs are not verified against manufacturer records
- Pre-1981 vehicles with non-standard serials may be excluded or flagged
- Market data pages cite official government and industry sources; TruckRadar does not independently verify this data
- AI-generated listing descriptions are factual summaries of listing fields only — no valuations, no condition opinions added beyond what the dealer provided